MCP Tools Reference: gmailmcp.googleapis.com

工具：label_thread

向经过身份验证的用户的 Gmail 账号中的整个会话添加标签。此操作会影响会话中当前的所有邮件以及将来添加到其中的任何邮件。

如果不确定会话 ID，请先使用 search_threads 工具。

如果不确定用户标签的 ID，请先使用 list_labels 工具来发现可用的标签及其 ID。如需向会话添加垃圾邮件标签或垃圾内容标签，请改用 apply_sensitive_thread_label 工具。

以下示例演示了如何使用 curl 调用 label_thread MCP 工具。

Curl 请求 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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

必需。要向其添加标签的会话的唯一标识符。
labelIds[]

string

必需。要添加的标签的唯一标识符。可以是系统标签 ID（例如“INBOX”“STARRED”“UNREAD”“IMPORTANT”）或用户定义的标签 ID。该工具接受 label_ids，但不接受标签名称。使用 list_labels 工具可获取用户定义的标签的显示名称对应的标签 ID。

输出架构

LabelThread RPC 的响应消息。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：❌ | 开放世界提示：❌

授权范围

需要以下 OAuth 范围之一：

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify