MCP Tools Reference: gmailmcp.googleapis.com

工具：create_draft

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

這項工具會將收件者地址、主旨和內文內容做為輸入內容。如果草稿是回覆現有訊息，則應將原始訊息的 ID 傳遞至工具的 replyToMessageId 欄位。

只會傳回草稿郵件的專屬 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 內容。如果提供這項資訊，系統會將其做為電子郵件的 RTF 版本。
replyToMessageId

string

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

object (Attachment)

(選用步驟) 要加入電子郵件的附件。郵件附件的總大小不得超過 25 MB。如要傳送超過 25 MB 的檔案，請先將檔案上傳至雲端硬碟，然後在郵件內文或 html_body 中插入雲端硬碟連結。

附件

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

string

(選用步驟) 僅供輸出。如有，則包含外部附件的 ID，可透過另一個 GetMessageAttachment 要求擷取。
filename

string

(選用步驟) 要附加的檔案名稱，例如「invoice.pdf」。如果是內嵌附件，這項屬性會用於產生 Content-ID。如果是一般附件，檔案名稱會用於指定電子郵件用戶端的檔案名稱。如果未提供名稱，收到的附件可能沒有名稱。
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

草稿資源的專屬 ID。
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