MCP Tools Reference: gmailmcp.googleapis.com

工具:create_draft

在经过身份验证的用户的 Gmail 账号中创建新的邮件草稿。

此工具将收件人地址、主题和正文内容作为输入,并返回所创建 Gmail 草稿的 ID。

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

输入架构

CreateDraft RPC 的请求消息。

CreateDraftRequest

JSON 表示法
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string
}
字段
to[]

string

必需。邮件草稿的主要收件人。每个字符串都必须是有效的电子邮件地址(例如“user@example.com”)。此工具不支持“Name email@example.com”格式。

cc[]

string

可选。邮件草稿的抄送收件人。每个字符串都必须是有效的电子邮件地址(例如“user@example.com”)。此工具不支持“Name email@example.com”格式。

bcc[]

string

可选。邮件草稿的密送收件人。每个字符串都必须是有效的电子邮件地址(例如“user@example.com”)。此工具不支持“Name email@example.com”格式。

subject

string

可选。邮件的主题行。如果未提供,则默认为空。

body

string

可选。邮件草稿的主要正文内容。如果还提供了 html_body,则此字段将被视为纯文本替代方案。

htmlBody

string

邮件草稿的 HTML 内容。如果提供,则此内容将用作邮件的富文本版本。

输出架构

草稿的详细信息。

草稿

JSON 表示法
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
字段
id

string

草稿资源的唯一标识符。

subject

string

草稿邮件的主题行。

threadId

string

此草稿所属的会话的 ID。

toRecipients[]

string

从标头中提取的“收件人”电子邮件地址列表。

ccRecipients[]

string

从标头中提取的“抄送”电子邮件地址列表。

bccRecipients[]

string

从标头中提取的“密送”电子邮件地址列表。

plaintextBody

string

纯文本正文内容(如果可用)。

date

string

草稿的日期,采用 ISO 8601 格式 (YYYY-MM-DD)。

工具注释

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