MCP tools: mail

Read and manage Thunderbird mail over MCP. write tools are registered only when ATBRIDGE_ALLOW_WRITES=1 — see the MCP overview. Pick a sender identity with accounts_list (system).

Tool	Access	Purpose	Key parameters
mail_fetch	read	Trigger Get Messages (new-mail check) now — call before searching for very recent mail	account_key
mail_folders	read	List folders across all accounts	—
mail_search	read	Search subject + body, newest first	query, from, to, subject, folder, account, since, until (YYYY-MM-DD or ISO 8601), limit, snippet, verbose
mail_list	read	Recent messages in a folder	folder (default INBOX), account, limit, verbose
mail_get	read	One message: headers, body, attachments	identifier, body (text|html|raw), include_headers
mail_thread	read	A whole conversation	identifier, limit
mail_attachments	read	List a message’s attachments (index, filename, type, size, partName, inline)	identifier
mail_attachment_get	read	Read one attachment’s content (text for text/*, else base64)	identifier, index or part_name, encoding (base64|text)
mail_send	write	Compose + send (or draft/template/later)	to[], subject, html/text, attachments[], identity, mode
mail_draft_edit	write	Edit an existing draft — only the fields you pass change	identifier, subject, to[], cc[], bcc[], html/text
mail_reply	write	Reply to a message	identifier, reply_type (replyToSender|replyToAll|replyToList), body
mail_forward	write	Forward a message	identifier, forward_type (forwardInline|forwardAsAttachment), to[]
mail_move	write	Move to another folder (bulk: identifiers[] or selector)	identifier | identifiers[] | selector, folder, max
mail_delete	write	Trash / hard delete (bulk: identifiers[] or selector)	identifier | identifiers[] | selector, hard, max
mail_mark	write	Update flags (bulk: identifiers[] or selector)	identifier | identifiers[] | selector, read, flagged, tags[], max
mail_folder_create	write	Create a folder (nested Parent/Child)	account, name
mail_folder_rename	write	Rename a folder	account, path, name
mail_folder_delete	write	Delete a folder (special-use protected)	account, path
mail_empty_trash	write	Permanently empty an account’s Trash	account, max

Lean by default — cheap gist, opt-in detail

mail_search and mail_list return lean rows (id, date, from/to, subject, read/flagged) — enough to pick a message. Pass snippet: true for a ~200-char plaintext gist per result — enough to answer “what’s the latest from X?” in a single call, with no follow-up mail_get. Pass verbose: true when you need the full routing metadata (headerMessageId, folderLabel, accountName, conversationId).

Branded HTML email (mail_compose) lives with the AI tools.