MCP Reference: gmailmcp.googleapis.com

これは Gmail API によって提供される MCP サーバーです。サーバーは、デベロッパーが Gmail を基盤として LLM アプリケーションを構築するためのツールを提供します。

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

サーバーの設定

使用する前に、Gmail MCP サーバーを構成する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法については、Google Cloud MCP サーバーの概要をご覧ください。

サーバーエンドポイント

MCP サービスエンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワークアドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。

Gmail API MCP サーバーには、次のグローバル MCP エンドポイントがあります。

https://gmailmcp.googleapis.com/mcp/v1

MCP ツール

MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。

ツール

gmailmcp.googleapis.com MCP サーバーには、次のツールがあります。

MCP ツール
create_draft	認証済みユーザーの Gmail アカウントに新しい下書きメールを作成します。このツールは、宛先アドレス、件名、本文の内容を入力として受け取ります。作成された Gmail の下書きの ID を返します。
list_drafts	認証されたユーザーの Gmail アカウントの下書きメールを一覧表示します。このツールでは、クエリ文字列に基づいて下書きをフィルタし、ページネーションをサポートできます。ID や件名など、下書きのリストが返されます。
get_thread	認証済みユーザーの Gmail アカウントから特定のメールスレッドを取得します（メッセージのリストを含む）。
search_threads	認証されたユーザーの Gmail アカウントのメールスレッドを一覧表示します。このツールは、クエリ文字列に基づいてスレッドをフィルタし、ページネーションをサポートしています。ID や関連するメッセージなど、スレッドのリストが返されます。各関連メッセージには、メッセージ本文のスニペット、件名、送信者、受信者などの詳細が含まれています。このツールではメッセージ本文全体は返されません。必要に応じて、スレッド ID を指定して get_thread ツールを使用し、メッセージ本文全体を取得してください。
label_thread	認証されたユーザーの Gmail アカウントのすべてのスレッドにラベルを追加します。この操作は、スレッド内のすべてのメッセージと、今後追加されるメッセージに影響します。スレッド ID が不明な場合は、まず `search_threads` ツールを使用します。ユーザーラベルの ID がわからない場合は、まず `list_labels` ツールを使用して、使用可能なラベルとその ID を確認します。
unlabel_thread	認証されたユーザーの Gmail アカウントのすべてのスレッドからラベルを削除します。スレッド ID が不明な場合は、まず `search_threads` ツールを使用します。ユーザーラベルの ID が不明な場合は、まず `list_labels` ツールを使用します。
list_labels	認証されたユーザーの Gmail アカウントで使用可能なユーザー定義ラベルをすべて一覧表示します。このツールを使用して、`label_thread`、`unlabel_thread`、`label_message`、`unlabel_message` を呼び出す前に、ユーザーラベルの `id` を検出します。このツールではシステムラベルは返されませんが、既知の ID（「INBOX」、「TRASH」、「SPAM」、「STARRED」、「UNREAD」、「IMPORTANT」、「CHAT」、「DRAFT」、「SENT」）で使用できます。
label_message	認証済みユーザーの Gmail アカウント内の特定のメッセージに 1 つ以上のラベルを追加します。メッセージ ID を確認するには、`search_threads` や `get_thread` などのツールを使用します。ユーザーラベルの ID がわからない場合は、まず `list_labels` ツールを使用して、使用可能なラベルとその ID を確認します。
unlabel_message	認証済みユーザーの Gmail アカウントの特定のメッセージから 1 つ以上のラベルを削除します。メッセージ ID を確認するには、`search_threads` や `get_thread` などのツールを使用します。ユーザーラベルの ID がわからない場合は、まず `list_labels` ツールを使用して、使用可能なラベルとその ID を確認します。
create_label	認証済みユーザーの Gmail アカウントに新しいラベルを作成します。

MCP ツールの仕様を取得する

MCP サーバー内のすべてのツールの MCP ツール仕様を取得するには、tools/list メソッドを使用します。次の例は、curl を使用して、MCP サーバー内で現在使用可能なすべてのツールとその仕様を一覧表示する方法を示しています。

Curl リクエスト
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'

Curl リクエスト

curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'