update_email_status

MCP tool from Apple Mail MCP by patrickfreyer

Mark read/unread, flag/unflag (optional flag color) — by filters or message IDs

How to use it

Project documentation lists update_email_status for the Apple Mail MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install Apple Mail MCP

$claude mcp add apple-mail -- uvx mcp-apple-mail
FULL APPLE MAIL MCP LISTING

Other tools in Apple Mail MCP (23)

compose_email

Send new emails (plain text or HTML body)

create_mailbox

Create new mailboxes (supports nested paths)

create_rich_email_draft

Build a rich HTML .eml draft, open it in Mail, and optionally save it to Drafts

export_emails

Export single emails or mailboxes to TXT/HTML

forward_email

Forward with optional message, CC/BCC

get_awaiting_reply

Find sent emails that haven't received a reply

get_email_thread

Conversation thread view

get_inbox_overview

Dashboard with unread counts, folders, and recent emails

get_mailbox_unread_counts

Unread counts per mailbox or per-account summary

get_needs_response

Identify emails that likely need your response

get_statistics

Email analytics (volume, top senders, read ratios)

get_top_senders

Analyse most frequent senders by count or domain

inbox_dashboard

Interactive UI dashboard (requires mcp-ui-server)

list_accounts

List all configured Mail accounts

list_email_attachments

List attachments with names and sizes

list_inbox_emails

List emails with account/read-status filtering and optional content preview

list_mailboxes

Folder hierarchy with message counts

manage_drafts

Create, list, send, and delete drafts

manage_trash

Soft delete, permanent delete, empty trash (with dry-run)

move_email

Move/archive emails with filters (subject, sender, date, read status, dry-run)

reply_to_email

Reply or reply-all with optional HTML body

save_email_attachment

Save attachments to disk

search_emails

Unified search — subject, sender, body text, dates, attachments, flag status/color, cross-account