MCP Tools Reference: gmailmcp.googleapis.com

工具：list_labels

列出经过身份验证的用户的 Gmail 账号中所有用户定义的标签。在调用 label_thread、unlabel_thread、label_message 或 unlabel_message 之前，使用此工具发现用户标签的 id。此工具不会返回系统标签，但可以使用其已知 ID：'INBOX'、'TRASH'、'SPAM'、'STARRED'、'UNREAD'、'IMPORTANT'、'CHAT'、'DRAFT'、'SENT'。

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

Curl 请求 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_labels",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

针对 ListLabels RPC 的请求消息。

ListLabelsRequest

JSON 表示法 
{

  "pageSize": integer

  "pageToken": string
}
字段

联合字段 _page_size。

_page_size 只能是下列其中一项：
pageSize

integer

可选。要返回的标签数量上限。

联合字段 _page_token。

_page_token 只能是下列其中一项：
pageToken

string

可选。用于检索列表中特定结果页面的分页令牌。

输出架构

ListLabels RPC 的响应消息。

ListLabelsResponse

JSON 表示法 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
字段
labels[]

object (Label)

用户账号中的用户标签列表。
nextPageToken

string

用于检索列表中下一页结果的令牌。

标签

JSON 表示法 
{
  "labelId": string,
  "name": string
}
字段
labelId

string

标签的唯一标识符。
name

string

标签的人类可读显示名称。

工具注释

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