Gmail MCP Server

Gmail MCP サーバー

FastMCP で構築された、Gmail 連携用の Model Context Protocol（MCP）サーバーです。このサーバーは、標準化されたツールを通じて、AI アシスタントが Gmail を操作できるようにします。

概要

このプロジェクトでは、AI アシスタントが次のようなさまざまな Gmail 操作を実行できる MCP サーバーを実装しています。

• 受信トレイからメールを取得する
• 件名でメールを検索する
• 特定の送信者からのメールを検索する
• 未読メールを取得する
• 宛先にメールを送信する

このサーバーは、メールの取得には IMAP を、メールの送信には SMTP を使用し、いずれも Gmail の認証システムで保護されています。

セットアップ

1. リポジトリをクローンします

git clone https://github.com/shubhiscoding/Gmail-MCP-Server
cd gmail-mcp

2. 依存関係をインストールします

npm install

3. ルートディレクトリに .env ファイルを作成し、次の変数を設定します。

GMAIL_USER=your_gmail_address
GMAIL_APP_PASSWORD=your-app-password

Gmail アカウントのアプリ パスワードを生成するには：

1. Google アカウント > セキュリティに移動します
2. まだ有効になっていない場合は、2 段階認証プロセスを有効にします
3. アプリ パスワードに移動します
4. 「メール」とお使いのデバイスを選択します
5. 「生成」をクリックします

使用方法

サーバーの起動

開発モードでサーバーを起動します。

npm run dev

Windsurf で実行するための設定

mcp_config.json を設定して、gmail-mcp サーバーを追加します。

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "bash",
      "args": [
        "-c",
        "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
      ],
      "disabled": false
    }
  }
}

Windows で Claude desktop を実行するための設定

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "cmd",
      "args": ["/c", "cd /d ~Your-Path-To-The-Repo\\Gmail-MCP-Server && npm run start"]
    }
  }
}

動画デモ

Windsruf のデモ

https://github.com/user-attachments/assets/0c45ec24-be45-4271-b7d0-fc6cd58b850f

Claude Desktop のデモ

https://github.com/user-attachments/assets/ad1650e8-bcc4-481e-ab95-eaefd8de7472

利用可能なツール

このサーバーは、AI アシスタント向けに次のツールを提供します。

1. fetchEmails

オプションの条件で絞り込みながら、受信トレイからメールを取得します。

パラメーター：

• limit（任意）：取得するメールの最大数（デフォルト：10）
• mailbox（任意）：メールを取得するメールボックス（デフォルト：'INBOX'）
• searchCriteria（任意）：IMAP 検索条件（デフォルト：['ALL']）

2. fetchEmailsBySubject

指定した件名のメールを取得します。

パラメーター：

• subject：検索する件名
• limit（任意）：取得するメールの最大数（デフォルト：10）

3. fetchEmailsFromSender

特定の送信者からのメールを取得します。

パラメーター：

• sender：送信者のメールアドレス
• limit（任意）：取得するメールの最大数（デフォルト：10）

4. fetchUnreadEmails

受信トレイから未読メールを取得します。

パラメーター：

• limit（任意）：取得するメールの最大数（デフォルト：10）

5. sendEmails

指定した宛先にメールを送信します。

パラメーター：

• to：宛先のメールアドレス
• subject：メールの件名
• body：メール本文

セキュリティ

このサーバーは、Gmail の認証情報などの機密情報を保存するために環境変数を使用します。.env ファイルをバージョン管理にコミットしないでください。

技術詳細

このプロジェクトは、次の技術で構築されています。

• 型安全性のための TypeScript
• メール操作用の Node.js IMAP および Nodemailer ライブラリ
• MCP サーバー実装用の FastMCP
• 環境変数管理用の dotenv