List email accounts this caller can act on (no secrets returned).

In multi-user OAuth mode, only the caller's own account is returned; in single-tenant mode, all configured accounts appear.

List every IMAP folder (mailbox) the account can see, UTF-7 decoded.

List the most recent messages in a folder (metadata only, newest first).

Use cursor (=previous next_cursor) to page further back in time.

IMAP SEARCH over one field. Wraps query in quotes for IMAP.

Note: IMAP SEARCH is substring, case-insensitive on most servers, and doesn't support boolean operators. For richer queries, chain calls.

Fetch full headers + body of a message. Attachments listed by name+mime.

Set include_attachments=true to also embed each attachment as base64 (respects the size limit; large attachments may push you over context).

Return message attachments as base64. Filter by filenames to save bytes.

Group messages sharing Message-ID / References / In-Reply-To headers.

Send an email. Supports HTML, attachments, and Save-to-Sent.

On retries after a client timeout, pass the same idempotency_key you used the first time to prevent duplicate delivery.

Reply to a message. Preserves Message-ID linking + Subject Re: prefix.

reply_all=true includes the original To and Cc in the reply.

Forward a message. Subject gets Fwd: prefix; original headers quoted.

Save an unsent draft in the account's Drafts folder.

Send a calendar invite (RFC 5545 ICS, METHOD:REQUEST).

Add the \Seen flag.

Remove the \Seen flag.

Add the \Flagged (starred) flag.

Remove the \Flagged flag.

Move a message between folders (RFC 6851 MOVE with COPY+EXPUNGE fallback).

Copy a message to another folder without removing the original.

Delete a message. Soft-delete by default (moves to Trash).

Create a new IMAP folder and subscribe to it.

Delete an empty IMAP folder. Fails if not empty (per RFC).

Rename an IMAP folder.