MCP Tools Reference: gmailmcp.googleapis.com

ツール: get_thread

認証済みユーザーの Gmail アカウントから特定のメール スレッド（メッセージのリストを含む）を取得します。

次のサンプルは、curl を使用して get_thread 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/call",
  "params": {
    "name": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

GetThread RPC のリクエスト メッセージ。

GetThreadRequest

JSON 表現 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
フィールド
threadId

string

必須。取得するスレッドの一意の識別子。
messageFormat

enum (MessageFormat)

省略可。スレッド内で返されるメッセージの形式を指定します。デフォルトは FULL_CONTENT です。注: 本文や添付ファイルが必要な場合は、FULL_CONTENT を使用します。MINIMAL を使用する場合、plaintext_body フィールドと attachment_ids フィールドは設定されません。どの形式を使用すべきかわからない場合は、FULL_CONTENT を使用してデフォルトの動作に依存してください。

MessageFormat

スレッド内のメッセージの詳細レベルを制御する列挙型。

列挙型
MESSAGE_FORMAT_UNSPECIFIED デフォルトは FULL_CONTENT です。
MINIMAL メッセージのスニペットと主要なヘッダー（件名、差出人、宛先、Cc、日付）を返します。
FULL_CONTENT 「MINIMAL」のすべての情報と、各メッセージの本文全体を返します。

出力スキーマ

メッセージのリストを含むスレッド。

スレッド

JSON 表現 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
フィールド
id

string

スレッドの一意の識別子。
messages[]

object (Message)

スレッド内のメッセージのリスト（時系列順）。

メッセージ

JSON 表現 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
フィールド
id

string

メッセージの一意の識別子。
snippet

string

メッセージ本文のスニペット。
subject

string

ヘッダーから抽出されたメッセージの件名:
sender

string

送信者のメールアドレス。
toRecipients[]

string

受信者のメールアドレス。
ccRecipients[]

string

Cc 受信者のメールアドレス。
date

string

メッセージの日付（ISO 8601 形式（YYYY-MM-DD））。
plaintextBody

string

本文のコンテンツ全体。MessageFormat が FULL_CONTENT の場合にのみ設定されます。
attachmentIds[]

string

出力専用。添付ファイルの ID。MessageFormat が FULL_CONTENT の場合にのみ入力されます。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌