MCP Tools Reference: gmailmcp.googleapis.com

工具：label_thread

在已驗證使用者的 Gmail 帳戶中，為整個郵件串加上標籤。這項操作會影響目前在對話串中的所有訊息，以及日後新增至對話串的訊息。

如果不確定執行緒 ID，請先使用 search_threads 工具。

如果不確定使用者標籤的 ID，請先使用 list_labels 工具找出可用的標籤及其 ID。

以下範例示範如何使用 curl 叫用 label_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": "label_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

LabelThread RPC 的要求訊息。

LabelThreadRequest

JSON 表示法 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
欄位
threadId

string

必填。要新增標籤的執行緒專屬 ID。
labelIds[]

string

必填。要新增標籤的專屬 ID。可以是系統標籤 ID (例如「INBOX」、「TRASH」、「SPAM」、「STARRED」、「UNREAD」、「IMPORTANT」)，也可以是使用者定義的標籤 ID。這項工具接受 label_ids，但不接受標籤名稱。使用 list_labels 工具，取得使用者定義標籤顯示名稱的對應標籤 ID。

輸出內容的結構定義

LabelThread RPC 的回應訊息。

工具註解

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