MCP Tools Reference: gmailmcp.googleapis.com

工具：create_draft

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

此工具将收件人地址、主题和正文内容作为输入。如果草稿是作为对现有邮件的回复而创建的，则应在 replyToMessageId 字段中将原始邮件的 ID 传递给该工具。

仅返回草稿邮件的唯一 ID (id)。

限制：尚不支持创建带附件的草稿。

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

输入架构

CreateDraft RPC 的请求消息。

CreateDraftRequest

JSON 表示法 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
字段
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 内容。如果提供此字段，系统会将其用作电子邮件的富文本版本。
replyToMessageId

string

可选。要回复的邮件的 ID。如果提供此字段，系统会将其用作电子邮件草稿的回复邮件 ID，并将 body 和 html_body 附加到原始邮件正文。
attachments[]

object (Attachment)

可选。要包含在电子邮件中的附件。邮件中附件的总大小不得超过 25MB。如果您需要发送大于 25MB 的文件，请先将文件上传到云端硬盘，然后将云端硬盘链接插入到正文或 html_body 中。

附件

JSON 表示法 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
字段
id

string

可选。仅限输出。如果存在，则包含可在单独的 GetMessageAttachment 请求中检索的外部附件的 ID。
filename

string

可选。要附加的文件的名称，例如“invoice.pdf”。对于内嵌附件，此字段用于生成 Content-ID。对于常规附件，filename 用于向电子邮件客户端指定文件名。如果未提供，则收到的附件可能没有名称。
mimeType

string

可选。表示内容或媒体类型的字段必须使用 IANA MIME 类型，网址为 https://www.iana.org/assignments/media-types/media-types.xhtml。如果未提供，则默认为“application/octet-stream”。
content

string (bytes format)

必需。附件的 base64 编码内容。

使用 base64 编码的字符串。
inline

boolean

可选。如果为 true，则此附件将作为内嵌附件处理。内嵌附件是指要在 HTML 电子邮件的正文中显示的内容，而不是作为单独的文件列出以供下载。如果为 false 或不存在，则默认为 false，并将其视为常规附件。

输出架构

草稿的详细信息。

草稿

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

string

草稿资源的唯一标识符。
subject

string

草稿邮件的主题行。
threadId

string

此草稿所属的会话的 ID。
toRecipients[]

string

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

string

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

string

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

string

纯文本正文内容（如果有）。
date

string

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

string

草稿的 HTML 正文内容（如果有）。

工具注释

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

授权范围

需要以下 OAuth 范围之一：

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