Email Inbox

email_setup

Auto-provision email on a Cloudflare account. Omit both domain and account_id to list connected accounts; omit domain (with account_id) to discover domains on that account; pass domain to provision.

email_accounts_list

List all connected Cloudflare accounts and the email domains provisioned on each. No secrets returned.

email_deprovision

Tear down a provisioned domain: delete its Cloudflare Worker + catch-all routing rule and mark the inbox deleted. Stored messages are retained.

email_repair

Repair a broken email provisioning: re-uploads the Cloudflare Worker script without tearing down the DB record or changing secrets. Use when email_status shows an error status.

email_send

Send an email via a provisioned Cloudflare Worker. Resolves the sending account from account_id, the from address domain, or the workspace default.

email_reply

Reply to an email (auto-sets threading headers). Set reply_all to include all original recipients. Pass `to`/`cc`/`subject` to override the derived recipients and subject (lets the user edit them in the composer before sending).

email_forward

Forward an email to one or more recipients. Pass `subject`/`text`/`html` to override the derived subject and the quoted body (lets the user edit them in the composer before sending); otherwise the original subject/body are quoted. Threading headers reference the original.

email_list

List emails with pagination and rich filtering (direction, thread, account, unread, starred, attachments, date range, custom folder/label).

email_threads

List conversations grouped by thread, with message/unread counts and the latest message preview.

email_thread_get

Fetch every message in a conversation thread in one call, oldest first, with full bodies — use this to render an ongoing email conversation.

email_get

Get a single email by ID. Optionally marks it read.

email_search

Full-text search across all emails with optional filters (direction, account, attachments).

email_status

Check email provision status and health, grouped per connected Cloudflare account. No secrets returned.

email_mark_read

Mark one or more emails read or unread (bulk).

email_star

Star or unstar one or more emails (bulk).

email_archive

Archive or unarchive conversations (or individual messages). Archiving removes them from the inbox without deleting.

email_delete

Delete one or more emails, or every message in the given threads.

email_update_account

Update the sending settings (from_address, display_name, reply_to) and catch-all toggle for a provisioned email account. When catch_all_enabled is toggled, Cloudflare routing is re-provisioned.

email_list_routing_rules

List the per-address routing rules for an email account (used when catch-all is off).

email_add_routing_rule

Add a per-address routing rule for an email account. Creates a Cloudflare Email Routing rule forwarding the address to the Worker and stores it.

email_delete_routing_rule

Delete a per-address routing rule for an email account. Removes the Cloudflare Email Routing rule and the stored row.

email_mailbox_list

List the email mailboxes (addresses) for a provisioned domain account.

email_mailbox_create

Create a new email mailbox (send-as address) on a provisioned domain. The address must be on the domain and is normalized to lowercase.

email_mailbox_update

Update a mailbox's address, display name, or reply-to. Only provided fields are changed.

email_mailbox_delete

Delete a mailbox from a domain. Refuses to delete a domain's last remaining mailbox.

email_mailbox_set_default

Set a mailbox as the default for its domain. Catch-all mail with no matching address lands here.

email_labels_list

List all custom folders/labels for this workspace (id, name slug, display_name, color, position).

email_labels_create

Create a custom folder/label. Returns the created label (id, name slug, display_name, color, position). The slug is derived from display_name and is stable across renames.

email_labels_rename

Rename a custom folder/label's display name. The stable slug (name) is never changed, so message assignments are preserved.

email_labels_delete

Delete a custom folder/label. Stored messages are retained; their folder/label assignment becomes stale (matches no messages when re-filtered).

email_move

Move one or more messages to a custom folder (bulk). Sets the message folder column and appends the label slug. Pass folder=null to remove from all custom folders.

email_draft_save

Create or update a composer draft. Pass `id` to update an existing draft, omit it to create a new one. Returns the saved draft.

email_drafts_list

List saved composer drafts for this workspace, most recently edited first.

email_draft_get

Get a single saved draft by id, with its full body and compose mode.

email_draft_delete

Delete a saved draft. Use after the draft has been sent, or when the user discards it.