mailmcp

Stores a file (text, or base64 for binary; up to policy.max_upload_bytes) in "mailmcp-uploads" and returns {folder, uid, part} to attach; it is removed once attached. Large or local files: request_upload.

upload_attachment

Lists folders (Gmail: labels) with message and unseen counts. On Outlook `path` is an opaque id and `name` the hierarchy ("Projects/2026"); tools accept either as a folder.

list_folders

Shows due follow-ups (optionally later ones) and snoozed messages across one or all mailboxes, including flags set in Outlook itself. Read-only; reports what it could not cover. Needs read; every plan.

list_followups

Lists the mailboxes: ids, addresses and permitted operations. `backend` "graph" is Outlook (string ids; labels are categories); `reauth_by`: when the owner must sign in to Microsoft again (setup page); `plan`: the mailmcp plan and, near expiry, how to renew. `protection`: verification emails hidden from you.

list_accounts

Lists templates in "mailmcp-templates", or one in full by name. samples=true returns the style profile and samples of the owner's sent mail, for tone, length and language only. Needs read; every plan.

list_templates

Files waiting in "mailmcp-uploads" of an account (from upload_attachment or an upload link), newest first, with the {folder, uid, part} needed to attach them.

list_uploads

Mark read/unread, star/unstar, add/remove labels (Gmail labels, Outlook categories), move to a folder or archive. A move can change the id of the message: when the result carries moved_uid, use that id from then on.

modify_message

Moves a message to the Trash folder. Never deletes permanently.

trash_message

Selects the exact messages a bulk action would act on (explicit uids or criteria, oldest first) and returns a count, senders, a sample and a confirm ref for bulk_apply. Changes nothing. Show the preview to the owner. Needs read and modify (trash: delete); 50 per call on Free, 500 paid.

bulk_preview

Returns headers, sanitized text body and the attachment list of one message. Body is truncated to the configured limit.

get_message

Sends a reply to a message in the same thread (threading headers, "Re:" subject, recipients and the quoted original are set by the server). Only when the owner enabled sending AND every recipient matches send_allowlist; otherwise use reply_draft. Only when the owner says "send" ("pošli", "odešli").

reply_send

Saves a reply to a message into Drafts, in the same thread: threading headers, "Re:" subject, recipients (sender, or all with reply_all) and the quoted original are set by the server. Use whenever the owner says "reply / write a draft" ("odpověz", "napiš koncept"). Nothing is sent.

reply_draft

Saves a text template, or with kind=profile a style profile (tone only), in "mailmcp-templates"; delete=true moves one mailmcp saved to Trash. Needs draft; templates are paid, profiles and deleting free.

save_template

Searches every readable mailbox with one query; returns documents for `fetch`. Gmail syntax on Gmail (from:, newer_than:7d, has:attachment), plain words elsewhere; prefix "account:<id> " for one mailbox. Outlook: Inbox only; Gmail: All Mail; search_messages with a folder looks elsewhere.

search

Searches one account, or all with account="all". Gmail: `query` takes Gmail syntax (from:, newer_than:7d, has:attachment, label:); elsewhere full text plus the filters. Newest first, with uid + folder and header hints. Outlook: `total` counts returned results only; `from` is exact.

search_messages

Sends a draft exactly as stored in the Drafts folder (including its attachments); it leaves Drafts (on Outlook it moves to Sent). Recipients are taken from the draft and must match send_allowlist.

send_draft

Sends an email via SMTP, optionally with attachments (existing mailbox attachments, uploaded files, inline content). Only allowed when the owner enabled sending for the account AND every recipient matches send_allowlist. Otherwise use create_draft.

send_message

Marks a message to come back to by a date: a record in "mailmcp-state" plus a star or flag. It resurfaces when list_followups or a scheduled task runs; clear=true removes it. Needs read and modify; setting is paid, clearing free.

set_followup

Stores the signature (HTML and/or text) as a message in the folder "mailmcp-signature". With a photo or logo the owner instead mails one to themselves and moves it there. Needs the mailbox signature enabled on the setup page and the draft capability.

set_signature

Returns the signature mailmcp appends under replies: the newest message in "mailmcp-signature" (HTML, inline images) when the account uses it, else the plain-text signature from the token.

get_signature

Moves one message (not its thread) to "mailmcp-snoozed" until a time, noting its origin; wake_snoozed or cancel=true brings it back. Needs read and modify; paid (cancel free).

snooze

Sorts recent mail into reply_candidates, waiting_on, newsletter, lists, calendar, automated and other from headers only (no bodies). Items carry reasons; you and the owner decide what needs a reply. Reports coverage per account. Needs read; every plan.

triage

Reads unsubscribe headers. The dry run (default) says if mailmcp can send an RFC 8058 one-click POST: only if your provider verified the signer's DKIM on them and the link is on its domain; else the manual link. Only when the owner asks. Needs read (execute: unsubscribe); every plan.

unsubscribe