MCP Tools Reference: gmailmcp.googleapis.com

Tool: `create_draft`

Creates a new draft email in the authenticated user's Gmail account.

This tool takes recipient addresses, a subject, and body content as inputs. It returns the ID of the created Gmail draft.

The following sample demonstrate how to use curl to invoke the create_draft MCP tool.

Curl Request
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 }'

Curl Request

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 
 }'

Input Schema

Request message for CreateDraft RPC.

CreateDraftRequest

JSON representation
{ "to" : [ string ] , "cc" : [ string ] , "bcc" : [ string ] , "subject" : string , "body" : string , "htmlBody" : string }

Fields
`to[]`	`string` Required. The primary recipients of the email draft. Each string MUST be a valid email address (e.g., "user@example.com"). The "Name email@example.com " format is NOT supported by this tool.
`cc[]`	`string` Optional. The carbon copy recipients of the email draft. Each string MUST be a valid email address (e.g., "user@example.com"). The "Name email@example.com " format is NOT supported by this tool.
`bcc[]`	`string` Optional. The blind carbon copy recipients of the email draft. Each string MUST be a valid email address (e.g., "user@example.com"). The "Name email@example.com " format is NOT supported by this tool.
`subject`	`string` Optional. The subject line of the email. Defaults to empty if not provided.
`body`	`string` Optional. The main body content of the email draft. If html_body is also provided, this field is treated as the plain-text alternative.
`htmlBody`	`string` The HTML content of the email draft. If provided, this will be used as the rich-text version of the email.

Output Schema

Details of a draft.

Draft

JSON representation
{ "id" : string , "subject" : string , "threadId" : string , "toRecipients" : [ string ] , "ccRecipients" : [ string ] , "bccRecipients" : [ string ] , "plaintextBody" : string , "date" : string }

Fields
`id`	`string` The unique identifier of the draft resource.
`subject`	`string` The subject line of the draft message.
`threadId`	`string` The ID of the thread this draft belongs to.
`toRecipients[]`	`string` List of 'To' recipient email addresses extracted from headers.
`ccRecipients[]`	`string` List of 'Cc' recipient email addresses extracted from headers.
`bccRecipients[]`	`string` List of 'Bcc' recipient email addresses extracted from headers.
`plaintextBody`	`string` Plain text body content, if available.
`date`	`string` Date of the draft in ISO 8601 format (YYYY-MM-DD).

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌