create-draft
Create a new email draft in Apple Mail for review before sending. Specify recipients, subject, body, and optional attachments; the draft is saved unsent.
Instructions
Use when: composing an email the user should review in Mail.app before sending — the safe default for any new message. Select a concrete From alias with from after list-sending-identities; account remains as a backwards-compatible account/identity selector.
Returns: the stable draft_id, actual From identity, recipients, subject, and attachment count.
Do not use when: editing an existing draft (use update-draft) or the user wants it sent now (use send-email).
Safety: creates and saves a draft only; it sends nothing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | CC recipients | |
| to | Yes | ||
| bcc | No | BCC recipients | |
| body | Yes | ||
| from | No | Sending identity id, email address, or formatted sender from list-sending-identities | |
| account | No | Deprecated compatibility selector: Mail account name or sender address | |
| subject | Yes | ||
| attachments | No | Files to attach: absolute paths (e.g. '/Users/me/report.pdf') and/or inline {filename, contentBase64} objects up to 25 MiB decoded each. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| from | No | ||
| subject | No | ||
| draft_id | No | ||
| recipients | No | ||
| attachmentCount | No |