工具: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[] |
必需。邮件草稿的主要收件人。每个字符串都必须是有效的电子邮件地址(例如“user@example.com”)。此工具不支持“Name email@example.com”格式。 |
cc[] |
可选。邮件草稿的抄送收件人。每个字符串都必须是有效的电子邮件地址(例如“user@example.com”)。此工具不支持“Name email@example.com”格式。 |
bcc[] |
可选。邮件草稿的密送收件人。每个字符串都必须是有效的电子邮件地址(例如“user@example.com”)。此工具不支持“Name email@example.com”格式。 |
subject |
可选。邮件的主题行。如果未提供,则默认为空。 |
body |
可选。邮件草稿的主要正文内容。如果还提供了 html_body,则此字段将被视为纯文本替代方案。 |
htmlBody |
邮件草稿的 HTML 内容。如果提供,则此内容将用作邮件的富文本版本。 |
输出架构
草稿的详细信息。
草稿
| JSON 表示法 |
|---|
{ "id": string, "subject": string, "threadId": string, "toRecipients": [ string ], "ccRecipients": [ string ], "bccRecipients": [ string ], "plaintextBody": string, "date": string } |
| 字段 | |
|---|---|
id |
草稿资源的唯一标识符。 |
subject |
草稿邮件的主题行。 |
threadId |
此草稿所属的会话的 ID。 |
toRecipients[] |
从标头中提取的“收件人”电子邮件地址列表。 |
ccRecipients[] |
从标头中提取的“抄送”电子邮件地址列表。 |
bccRecipients[] |
从标头中提取的“密送”电子邮件地址列表。 |
plaintextBody |
纯文本正文内容(如果可用)。 |
date |
草稿的日期,采用 ISO 8601 格式 (YYYY-MM-DD)。 |
工具注释
破坏性提示:❌ | 等幂性提示:❌ | 只读提示:❌ | 开放世界提示:❌