updateDraft
Update Email Draft
Edit a Gmail draft that is already staged, IN PLACE, by its draftId: the draft keeps its draftId and stays the only draft on its thread, instead of a second draft appearing in the conversation…
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "change the draft", and it calls updateDraft.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"draftId": "<draftId>"
},
"name": "updateDraft"
}Arguments
blocksobject[]optionalStructured rich email body. When present, it wins over richBody and body for the HTML part; bodyHtml wins over it.bodystringoptionalPlain text email body. Required unless `bodyHtml`, `blocks` or `richBody` is provided; when combined with any of them, this is the explicit text/plain part (otherwise that part is derived from the HTML).bodyHtmlstringoptionalYour own finished HTML email (a designed transactional email: receipt, confirmation, welcome) sent 1:1 as the HTML part. Precedence: bodyHtml wins over blocks and richBody for the HTML part; `body` is the explicit text part, else the text…richBodystringoptionalMarkdown email body for formatted mail. Supports paragraphs, h1-h3 headings, bold, italic, links (a bold link is `[**text**](url)` or `**[text](url)**`), lists, blockquote, inline and fenced code, horizontal rules, image URLs, and inline…accountIdstringoptionalConnected account this acts on: an accountId or email from listMailAccounts. Omit for the primary account. Pass the SAME account you found the message / draft / label in: a Gmail id is per-account, so aiming a non-primary id at the…attachmentsobject[]optionalCloud files to attach, in order: up to 20 files, 25 MB in total. Page exports are not attachable, so attach the PDF as a Cloud file if there is one. Only promise an attachment after the result comes back with it in `attached`.docContractstringoptionalThe type-slug of the doc contract this is filed under (e.g. "handoff-memo"), when it is a staple rather than ordinary prose. The server validates the text against that contract and refuses a malformed one, handing back the contract's…draftIdstringrequiredThe draft to edit (from createDraft or listDrafts)fromstringoptionalAlias of `accountId`: the account to act as, an accountId or email from listMailAccounts. `accountId` wins if both are given.stagedBystringoptionalYour chip or seat name, recorded as who last staged this draft. Omit to record the MCP session.subjectstringoptionalNew subject line. Omit to keep the staged one. No [DRAFT] or similar prefix.
Returns
The registry does not declare a return shape.
Declared limits
blocks: minimum items 1blocks: maximum items 100attachments: maximum items 20
Ask for it
The Cloud routes these requests to this verb.
- change the draft
- redraft that reply
- edit the staged email
- update the draft
Pair it with
The verbs that finish the job.
Questions
What does updateDraft do?
Edit a Gmail draft that is already staged, IN PLACE, by its draftId: the draft keeps its draftId and stays the only draft on its thread, instead of a second draft appearing in the conversation… It is one of the tools The Cloud MCP server gives every connected AI.
How do I use updateDraft from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "change the draft", and it calls updateDraft.
Is updateDraft safe to let an AI call?
updateDraft changes your workspace. What an AI creates is Private until you share it. It reaches a system outside The Cloud on your behalf.
Connect
One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.