MCP Tools Reference: gmailmcp.googleapis.com

工具：create_draft

在已驗證使用者的 Gmail 帳戶中建立新的電子郵件草稿。

這項工具會將收件者地址、主旨和內文內容做為輸入內容。並傳回建立的 Gmail 草稿 ID。如果草稿是回覆現有訊息，則應將原始訊息的 ID 傳遞至 replyToMessageId 欄位中的工具。目前還不支援建立含有附件的草稿。

以下範例示範如何使用 curl 叫用 create_draft 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_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
}
欄位
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 內容。如果提供這項資訊，系統會將其做為電子郵件的 RTF 版本。
replyToMessageId

string

(選用步驟) 要回覆的訊息 ID。如有提供，系統會將此 ID 用於電子郵件草稿的回覆郵件 ID，並在原始郵件內文中附加 body 和 html_body。

輸出內容的結構定義

草稿詳細資料。

草稿

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

string

草稿資源的專屬 ID。
subject

string

草稿郵件的主旨行。
threadId

string

草稿所屬的執行緒 ID。
toRecipients[]

string

從標頭擷取的「收件者」電子郵件地址清單。
ccRecipients[]

string

從標頭擷取的「副本」收件者電子郵件地址清單。
bccRecipients[]

string

從標頭擷取的「密件副本」收件者電子郵件地址清單。
plaintextBody

string

純文字內文內容 (如有)。
date

string

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

工具註解

破壞性提示：❌ | 等冪提示：❌ | 唯讀提示：❌ | 開放世界提示：❌