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

必填。要擷取的執行緒專屬 ID。
messageFormat

enum (MessageFormat)

(選用步驟) 指定要在執行緒中傳回的訊息格式。預設值為 FULL_CONTENT。注意：如需郵件內文或附件，請使用 FULL_CONTENT。使用 MINIMAL 時，系統不會填入 plaintext_body 和 attachment_ids 欄位。如果不確定要使用哪種格式，請使用 FULL_CONTENT 採用預設行為。

MessageFormat

列舉，用於控制討論串中訊息的詳細程度。

列舉
MESSAGE_FORMAT_UNSPECIFIED 預設為 FULL_CONTENT。
MINIMAL 傳回郵件摘要和重要標頭 (主旨、寄件者、收件者、副本、日期)。
FULL_CONTENT 傳回「MINIMAL」中的所有資訊，以及每封郵件的完整內文內容。

輸出內容的結構定義

包含訊息清單的討論串。

討論串

JSON 表示法 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
欄位
id

string

執行緒的專屬 ID。
messages[]

object (Message)

依時間順序排列的訊息串清單。

訊息

JSON 表示法 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
欄位
id

string

訊息的專屬 ID。
snippet

string

郵件內文的程式碼片段。
subject

string

從標頭擷取的郵件主旨：
sender

string

寄件者的電子郵件地址。
toRecipients[]

string

收件者的電子郵件地址。
ccRecipients[]

string

副本收件者的電子郵件地址。
date

string

訊息日期，採用 ISO 8601 格式 (YYYY-MM-DD)。
plaintextBody

string

完整內文內容，只有在 MessageFormat 為 FULL_CONTENT 時才會填入。
attachmentIds[]

string

僅供輸出。附件 ID，只有在 MessageFormat 為 FULL_CONTENT 時才會填入。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌