Connect the Gmail MCP server to your AI agent Open source, MIT, on npm. Setup instructions for Claude, Cursor and Codex are in the repository; adoption questions — Telegram. GitHub repository Telegram

Gmail: Read a draft — MCP tool

Gmail MCP tool: Fetches one draft with its message decoded into readable headers and body.

Technical name: get_draft

What task it solves

I want to see exactly what a draft says.

Shows the draft as it would be sent: recipients, subject, decoded body, attachment metadata.

When to use it

Always before send_draft (show the user what will go out) and before update_draft (updates replace the whole draft, so the current content must be known).

What to provide

  • draft_idrequired. From list_drafts or create_draft.
  • include_htmloptional. Decoded HTML body even when a text body exists (default false).
  • max_body_charsoptional. Body truncation limit (default 50000).

What it returns

The draft id and its message, decoded like get_message: headers (to, cc, subject, ...), text/html with truncation flags, attachments[] metadata, threadId for reply drafts.

What changes in Gmail

Nothing — a pure read.

Example request

Show me the current text of my draft to the supplier before we send it.

Errors and limitations

A 404 means the draft was already sent or deleted — its id is consumed on send. Access also depends on token permissions, quotas, and upstream API limits.

Related MCP tools

Technical details