draft_gmail_message

Generate draft emails in Gmail with subject, body, and optional recipients. Supports new drafts or replies within threads, ensuring proper email threading with Message-IDs.

Instructions

Creates a draft email in the user's Gmail account. Supports both new drafts and reply drafts.

Args: user_google_email (str): The user's Google email address. Required. subject (str): Email subject. body (str): Email body (plain text). to (Optional[str]): Optional recipient email address. Can be left empty for drafts. cc (Optional[str]): Optional CC email address. bcc (Optional[str]): Optional BCC email address. thread_id (Optional[str]): Optional Gmail thread ID to reply within. When provided, creates a reply draft. in_reply_to (Optional[str]): Optional Message-ID of the message being replied to. Used for proper threading. references (Optional[str]): Optional chain of Message-IDs for proper threading. Should include all previous Message-IDs.

Returns: str: Confirmation message with the created draft's ID.

Examples: # Create a new draft draft_gmail_message(subject="Hello", body="Hi there!", to="user@example.com")

# Create a draft with CC and BCC draft_gmail_message( subject="Project Update", body="Here's the latest update...", to="user@example.com", cc="manager@example.com", bcc="archive@example.com" ) # Create a reply draft draft_gmail_message( subject="Re: Meeting tomorrow", body="Thanks for the update!", to="user@example.com", thread_id="thread_123", in_reply_to="<message123@gmail.com>", references="<original@gmail.com> <message123@gmail.com>" )

Input Schema

Name	Required	Description
`bcc`	No	Optional BCC email address.
`body`	Yes	Email body (plain text).
`cc`	No	Optional CC email address.
`in_reply_to`	No	Optional Message-ID of the message being replied to.
`references`	No	Optional chain of Message-IDs for proper threading.
`subject`	Yes	Email subject.
`thread_id`	No	Optional Gmail thread ID to reply within.
`to`	No	Optional recipient email address.
`user_google_email`	Yes

Input Schema (JSON Schema)

{ "properties": { "bcc": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional BCC email address.", "title": "Bcc" }, "body": { "description": "Email body (plain text).", "title": "Body", "type": "string" }, "cc": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional CC email address.", "title": "Cc" }, "in_reply_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional Message-ID of the message being replied to.", "title": "In Reply To" }, "references": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional chain of Message-IDs for proper threading.", "title": "References" }, "subject": { "description": "Email subject.", "title": "Subject", "type": "string" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional Gmail thread ID to reply within.", "title": "Thread Id" }, "to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional recipient email address.", "title": "To" }, "user_google_email": { "title": "User Google Email", "type": "string" } }, "required": [ "user_google_email", "subject", "body" ], "type": "object" }

Google Workspace MCP Server