Gmail Server for Model Context Protocol (MCP)

Model Context Protocol（MCP）用 Gmail サーバー

この MCP サーバーは Gmail と連携し、メールの送信、削除、閲覧、下書きの作成、返信を可能にします。

注：このサーバーにより、MCP クライアントはメールの閲覧、削除、送信ができます。ただし、こうした操作を行う前に、クライアントはユーザーに確認を求めます。

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

コンポーネント

ツール

• send-email

  • メールアドレスの宛先にメールを送信します
  • 入力：
    • recipient_id (string)：宛先のメールアドレス
    • subject (string)：メールの件名
    • message (string)：メールの内容
  • ステータスと message_id を返します

• trash-email

  • メールをゴミ箱に移動します
  • 入力：
    • email_id (string)：メールの自動生成 ID
  • 成功メッセージを返します

• mark-email-as-read

  • メールを既読にします
  • 入力：
    • email_id (string)：メールの自動生成 ID
  • 成功メッセージを返します

• get-unread-emails

  • 未読メールを取得します
  • メール ID を含むメールのリストを返します

• read-email

  • 指定されたメールの内容を取得します
  • 入力：
    • email_id (string)：メールの自動生成 ID
  • メールのメタデータの辞書を返し、メールを既読にします

• open-email

  • ブラウザーでメールを開きます
  • 入力：
    • email_id (string)：メールの自動生成 ID
  • 成功メッセージを返し、指定されたメールを既定のブラウザーで開きます

セットアップ

Gmail API のセットアップ

1. 新しい Google Cloud プロジェクトを作成します
2. Gmail API を有効にします
3. OAuth 同意画面を設定します
   • 「external」を選択します。ただし、アプリは公開しません。
   • 個人のメールアドレスを「Test user」として追加します。
4. OAuth スコープ https://www.googleapis.com/auth/gmail/modify を追加します
5. アプリケーションの種類に「Desktop App」を選択して、OAuth クライアント ID を作成します
6. クライアントの OAuth キーの JSON ファイルをダウンロードします
7. キーファイルの名前を変更し、安全な場所にあるローカルマシンに保存します。保存場所を控えておいてください。
   • このファイルの絶対パスは、サーバー起動時にパラメーター --creds-file-path として渡します。

認証

サーバーを起動すると、システムブラウザーで認証フローが開始されます。 トークン認証情報は、パラメーター --token-path に渡した絶対ファイルパスに保存されます（後でそこから取得されます）。

たとえば、ホームフォルダーのドットディレクトリを使用できます。その場合は、[your-home-folder] を置き換えてください。：

パラメーター	例
--creds-file-path	/[your-home-folder]/.google/client_creds.json
--token-path	/[your-home-folder]/.google/app_tokens.json

デスクトップアプリでの使用

uv の使用をおすすめします。

このサーバーを MCP クライアントとして Claude Desktop と連携するには、アプリのサーバー設定に次の内容を追加します。既定では、設定は ~/Library/Application\ Support/Claude/claude_desktop_config.json に保存されています。

{
  "mcpServers": {
    "gdrive": {
      "command": "uv",
      "args": [
        "--directory",
        "[absolute-path-to-git-repo]",
        "run",
        "gmail",
        "--creds-file-path",
        "[absolute-path-to-credentials-file]",
        "--token-path",
        "[absolute-path-to-access-tokens-file]"
      ]
    }
  }
}

次のパラメーターを設定する必要があります

パラメーター	例
--directory	サーバーを含む gmail ディレクトリの絶対パス
--creds-file-path	Gmail API のセットアップで作成した認証情報ファイルの絶対パス。
--token-path	アプリケーションのアクセス・更新トークンを保存および取得するための絶対パス。

MCP Inspector によるトラブルシューティング

サーバーをテストするには、MCP Inspector を使用します。 Git リポジトリから、パラメーターの引数を適宜変更して、以下を実行します。

npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]