What does createDraft do?

Create a Gmail draft without sending it. It is one of the tools The Cloud MCP server gives every connected AI.

How do I use createDraft 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 "draft an email", and it calls createDraft.

Is createDraft safe to let an AI call?

createDraft changes your workspace. What an AI creates is Private until you share it. It reaches a system outside The Cloud on your behalf.

`createDraft`

Create Email Draft

Create a Gmail draft without sending it.

writeexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "draft an email", and it calls createDraft.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "subject": "<subject>"
  },
  "name": "createDraft"
}

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…
acknowledgedstring[]optionalBuilt-in outbound checks you are knowingly relaxing for THIS send. Pass ["humble-ask"] only when the user wants the text sent as written after the humble-ask refusal; acknowledgedReason is required with it.
acknowledgedReasonstringoptionalWhy the acknowledged check is relaxed for this send, in one line. Logged with the rail and the phrases it let through.
accountIdstringoptionalAlias of `from`: the accountId from listMailAccounts. Takes precedence over `from` if both are given.
allowAnotherbooleanoptionalStage a second draft on a thread where the Cloud already holds one, instead of updating the held draft in place. The older draft stays and is marked supersededBy this one in listDrafts.
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`.
bccstringoptionalBCC email address (optional)
ccstringoptionalCC email address (optional)
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…
fromstringoptionalAccount to draft AS: an accountId or email from listMailAccounts. Omit to draft from the primary account. The draft LIVES in this account: pass the same value to listDrafts/deleteDraft to find and remove it.
replacesstringoptionalA draftId the Cloud staged in this account, deleted once this draft is created, for a caller that swaps drafts instead of calling updateDraft. A draft the Cloud did not stage is refused. The result says whether it was deleted.
replyAllbooleanoptionalReply to EVERYONE on the original (its sender plus every To recipient in To, its Cc in Cc), minus the user's own addresses. Only meaningful with replyToMessageId and no explicit `to`.
replyToMessageIdstringoptionalMessage ID this draft replies to. Threads the draft and composes its recipients from the original.
stagedBystringoptionalYour chip or seat name, shown as who staged this draft in listDrafts and the Cloud's thread view. Omit to record the MCP session.
subjectstringrequiredEmail subject line, exactly as it should send. No [DRAFT] or similar prefix.
tostringoptionalRecipient email address. Omit ONLY when drafting a reply (replyToMessageId set). The recipients are then composed from the original message.

Returns

Returns the draftId.

Declared limits

blocks: minimum items 1
blocks: maximum items 100
attachments: maximum items 20

Ask for it

The Cloud routes these requests to this verb.

draft an email
start a message to X
draft a reply
write but don't send
redraft that reply

Pair it with

The verbs that finish the job.

Questions

What does createDraft do?
Create a Gmail draft without sending it. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use createDraft 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 "draft an email", and it calls createDraft.
Is createDraft safe to let an AI call?
createDraft 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.