MCP Reference: gmailmcp.googleapis.com

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

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 アカウントで使用可能なユーザー定義ラベルをすべて一覧表示します。このツールを使用して、ユーザーラベルの id を呼び出す前に label_thread、unlabel_thread、label_message、または unlabel_message を確認してください。システムラベルはこのツールでは返されませんが、既知の 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' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'