
Apple Mail
Search and read Apple Mail on macOS, read-only: mailboxes, messages and threads.
- tools
- 4
- transport
- STDIO
- last updated
- Nov 12, 2026
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
list_mailboxesAccounts and visible mailboxes with total and unread counts and a role (inbox, sent, junk, ...).
Accounts and visible mailboxes with total and unread counts and a role (inbox, sent, junk, ...).
No parameter schema in public metadata yet.
search_messagesNewest-first search by sender, recipient, subject, free text, mailbox, dates, unread, flagged, attachment, and optionally body text. Paginated with a cursor.
Newest-first search by sender, recipient, subject, free text, mailbox, dates, unread, flagged, attachment, and optionally body text. Paginated with a cursor.
No parameter schema in public metadata yet.
get_messageOne message: headers, attachment names, body as plain text, optional removal of quoted replies.
One message: headers, attachment names, body as plain text, optional removal of quoted replies.
No parameter schema in public metadata yet.
get_threadThe messages of one conversation, oldest first, without bodies.
The messages of one conversation, oldest first, without bodies.
No parameter schema in public metadata yet.
Sponsors
Readme
apple-mail-mcp
A read-only MCP server that lets an AI assistant search and read the mail in Apple Mail.
macOS only. It reads the local index that Mail.app keeps on your Mac.
claude mcp add apple-mail -- npx -y @redpop/apple-mail-mcp
Then grant Full Disk Access once with npx -y @redpop/apple-mail-mcp setup. For Claude
Desktop there is a one-click bundle: see Install.
What it does
The main use is "find the mail about X":
"Find the mail from the landlord about the heating bill"
"What did Anna send me last week with an attachment?"
"Show the whole thread about the contract renewal"
Four tools: list_mailboxes, search_messages, get_message, get_thread. Search covers
sender, recipient, subject, free text, mailbox, date range, unread, flagged and attachments,
and can also look inside message bodies. Results carry a message:// link that opens the
mail in Mail.app, where Mail stores the Message-ID (not on macOS 15). Details: docs/tools.md.
Why this one
Details
- Repository
- github.com/redpop/apple-mail-mcp
- Category
- Search & Web Crawling
- Package
@redpop/apple-mail-mcp- Transport
- STDIO
- Registry
- MCP registry, active