Gmail MCPサーバーの統合

「Gmail」MCPサーバーは何をする？

Gmail MCPサーバーは、Claude DesktopなどのAIプラットフォームにGmail機能を統合するために設計されたModel Context Protocol（MCP）サーバーです。主な役割は、AIアシスタントとGmail間のブリッジとなり、自然言語でメール管理を可能にすることです。これにはメールの送受信、ラベル管理、添付ファイルの取り扱い、特定メッセージの検索、バッチ操作の実行などが含まれます。これらの機能をMCPツールやリソースとして公開することで、Gmail MCPサーバーは開発者に強力なワークフロー構築を可能にし、AIエージェントによるメール管理の自動化や、受信箱からのコンテキストデータ取得、Gmail内容のプログラム的操作を、OAuth2による安全な認証のもとで実現します。

プロンプト一覧

リポジトリやドキュメントには明示的なプロンプトテンプレートは記載されていません。

リソース一覧

• メールメッセージ
  メールメッセージをリソースとして公開し、LLMとのやりとりに利用できます。

• Gmailラベル
  システムラベル・ユーザー定義ラベルの両方にアクセスでき、メールの整理や検索に活用可能です。

• 添付ファイルのメタデータ
  添付ファイルのファイル名・種類・サイズなどの情報を取得可能です。

• 検索結果
  件名・送信者・日付範囲などによる高度な検索結果にアクセスできます。

ツール一覧

ドキュメントに記載された機能に基づき、Gmail MCPサーバーが提供するツールは次の通りです：

• send_email
  件名・本文・添付ファイル・受信者を指定したメール送信。HTMLや国際文字もサポート。

• read_email
  IDでメールメッセージを取得。複雑なMIME構造も対応。

• list_labels
  システム・ユーザー定義すべてのGmailラベルを一覧。

• manage_labels
  ラベルの作成・更新・削除・一覧など、ラベル管理を一括して可能。

• search_emails
  件名・送信者・日付範囲など多様な条件でメール検索。

• list_emails_by_label
  受信トレイ・送信済み・カスタムラベルごとにメール一覧表示。

• mark_read_unread
  メールの既読/未読の切り替え。

• move_email
  メールをラベル（フォルダ）間で移動。

• delete_email
  メールを削除。

• batch_operations
  複数メールに一括で操作。

このMCPサーバーのユースケース

• 自動メール送信
  AIエージェントが自動でメール作成・送信を行い、定型連絡の手間を削減。

• 受信箱トリアージ・管理
  AIアシスタントがメールをカテゴリ分け・ラベル付け・移動し、受信箱を整理して重要なメールを優先できます。

• メール検索・取得
  高度な検索条件で目的のメッセージや添付ファイルを素早く抽出し、Gmailからの情報取得を効率化。

• バッチ処理
  大量のメールに対する削除・既読/未読切替・移動などを自動化し、高頻度利用者の作業時間を短縮。

• ラベル管理自動化
  AIがユーザーニーズやプロジェクトに応じて、Gmailラベルを自動生成・更新・削除し柔軟な整理を実現。

セットアップ手順

Windsurf

1. Node.jsなどの前提条件がインストールされていることを確認します。
2. Windsurf設定ファイル（一般的には windsurf.json など）を開きます。
3. Gmail MCPサーバーパッケージを追加します:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. 設定を保存し、Windsurfを再起動します。
5. MCPサーバーがWindsurfダッシュボードに表示されているか確認します。

APIキーの安全な管理例:

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude

1. Node.jsとClaudeプラットフォームがセットアップされていることを確認します。
2. ClaudeのMCP設定ファイルを編集します。
3. Gmail MCPサーバーを追加します:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. 設定を保存し、Claudeを再起動します。
5. Claude内でサーバーが有効になっていることを確認します。

環境変数の例:

{
  "env": {
    "GOOGLE_CLIENT_ID": "your-client-id",
    "GOOGLE_CLIENT_SECRET": "your-client-secret"
  }
}

Cursor

1. Node.jsをインストールし、Cursorが動作していることを確認します。
2. Cursorの設定にGmail MCPサーバーを追加します:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. 変更を反映させるためCursorを再起動します。
4. MCPサーバーが利用可能か確認します。

Cline

1. Node.jsがインストールされていることを準備します。
2. Clineの設定にGmail MCPサーバーを記載します:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. 保存後、Clineを再起動します。
4. インターフェース上でGmail MCPサーバーが認識されているか確認します。

注意:
APIキーや認証情報は必ず環境変数で管理し、設定ファイルに直接書き込まないでください。安全な認証情報注入にはMCPサーバー設定の env プロパティを利用しましょう。

フロー内でのMCPの使い方

FlowHuntでのMCP利用方法

FlowHuntのワークフローにMCPサーバーを統合するには、まずMCPコンポーネントを追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションにて、次のJSON形式でMCPサーバー情報を入力します。

{
  "gmail-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AIエージェントはこのMCPをツールとして利用できるようになり、すべての機能にアクセス可能です。“gmail-mcp"は実際のMCPサーバー名に、URLは自分のMCPサーバーURLに置き換えてください。

概要

ドキュメント情報から見ると、Gmail MCPサーバーはGmailワークフロー自動化・統合のための機能が充実している一方、明示的なプロンプトテンプレートやサンプリング/rootsの記載は見当たりません。セキュリティ管理やツール・リソース公開は強力なので、開発者対応度として10点満点中7.5点と評価します。

MCPスコア