List all configured email accounts and their connection status

Add a new IMAP or iCloud email account (Gmail and Outlook require the setup wizard for OAuth)

Remove an email account

Test an email account connection

List all email folders for an account

Search emails with filters. By default returns compact results without full body content to save context. Set returnBody=true to include full email bodies.

Get a single email by ID

Get an email thread by thread ID

Get an email attachment by ID, returns base64 encoded data

Send exactly one email after explicit confirmation. confirmed=true and a nonblank idempotencyKey are required safety inputs. Reuse synchronized mail with {messageId, attachmentId} from mail_attachment_list; use {stagedId} from mail_attachment_stage/mail_attachment_create for local or agent-created files; or use {localPath, confirmed:true} for an authorized workspace/import file.

Reply to an existing email

Forward an email to new recipients

Create exactly one provider draft with optional retained, staged, or confirmed local attachments. A nonblank idempotencyKey is required; reuse it only for the identical draft so retries return the durable prior result without creating a duplicate.

List email drafts

Move an email to a different folder

Move or copy emails between accounts while preserving raw MIME

Delete an email (moves to trash by default, or permanently deletes)

Mark an email as read/unread, starred, or flagged

Add or remove labels on an email (Gmail only)

Create a new email folder

List all labels for an email account (Gmail only)

List all categories for an email account (Outlook only)

Delete multiple emails at once. Much faster than individual deletes.

Move multiple emails to a folder at once. Much faster than individual moves.

Mark multiple emails at once (read/unread, starred, flagged). Much faster than individual marks.

Perform a full initial mailbox synchronization and reconciliation.

Run an incremental sync, or force a full reconciliation.

Synchronize every enabled account.

Return freshness, cursor status, and local object counts.

Validate OKF frontmatter and attachment references for one account.

Regenerate the OKF projection from the canonical SQLite records.

Search the local knowledge corpus with keyword, semantic, or hybrid retrieval.

Retrieve a source-backed knowledge record for a message.

Apply CocoIndex incremental changes from OKF files into sqlite-vec.

Run account-isolated semantic similarity search over the OKF vector index.

Stage an authorized file and return {stagedId, filename?} for send or draft.

List retained metadata reusable as {messageId, attachmentId, filename?} selectors.

Create an agent-generated text/base64 file for later send or draft attachment.