MCP Tools Reference: gmailmcp.googleapis.com

工具：create_label

在经过身份验证的用户的 Gmail 账号中创建新标签。

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

输入架构

针对 CreateLabel RPC 的请求消息。

CreateLabelRequest

JSON 表示法 
{
  "displayName": string,

  "color": {
    object (LabelColor)
  }
}
字段
displayName

string

必需。要创建的标签的显示名称。

联合字段 _color。

_color 只能是下列其中一项：
color

object (LabelColor)

可选。标签的颜色。

LabelColor

JSON 表示法 
{
  "textColor": string,
  "backgroundColor": string
}
字段
textColor

string

标签的文字颜色，以十六进制字符串表示（例如，“#000000”）。
backgroundColor

string

标签的背景颜色，以十六进制字符串表示（例如“#ffffff”）。

输出架构

标签的详细信息。

标签

JSON 表示法 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
字段
labelId

string

标签的唯一标识符。
name

string

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

object (LabelColor)

可选。标签的颜色。

联合字段 _threads_total。

_threads_total 只能是下列其中一项：
threadsTotal

integer

相应标签下的线程总数。

联合字段 _threads_unread。

_threads_unread 只能是下列其中一项：
threadsUnread

integer

相应标签下的未读消息串数量。

LabelColor

JSON 表示法 
{
  "textColor": string,
  "backgroundColor": string
}
字段
textColor

string

标签的文字颜色，以十六进制字符串表示（例如，“#000000”）。
backgroundColor

string

标签的背景颜色，以十六进制字符串表示（例如“#ffffff”）。

工具注释

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