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 | Default |
|---|---|---|---|
| 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 |