MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails via natural language
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"apple-mail": {
"args": [
"mcp-apple-mail"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
An MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language. Built with FastMCP.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'mcp-apple-mail' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked mcp-apple-mail against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in communication
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
PubNub Model Context Protocol MCP Server for Cursor and Claude
Social layer for Claude Code - DMs, presence, discovery, and games between AI-assisted developers
MCP server for Voximplant API — call history, users, SMS. 3 tools.
MCP Security Weekly
Get CVE alerts and security updates for Apple Mail Mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
An MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language. Built with FastMCP.
Prerequisites: macOS with Apple Mail configured, Python 3.10+
Two commands — gets you the MCP server, /email-management slash command, and the Email Management Expert skill:
claude plugin marketplace add patrickfreyer/apple-mail-mcp
claude plugin install apple-mail@apple-mail-mcp
Then restart Claude Code.
claude mcp add apple-mail -- uvx mcp-apple-mail
Or for Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"apple-mail": {
"command": "uvx",
"args": ["mcp-apple-mail"]
}
}
}
pip install mcp-apple-mail
claude mcp add apple-mail -- mcp-apple-mail
apple-mail-mcp-vX.Y.Z.mcpb from Releases.mcpb file and grant Mail.app permissionsgit clone https://github.com/patrickfreyer/apple-mail-mcp.git
cd apple-mail-mcp/plugin
python3 -m venv venv
venv/bin/pip install -r requirements.txt
claude mcp add apple-mail -- /bin/bash $(pwd)/start_mcp.sh
| Tool | Description |
|---|---|
get_inbox_overview | Dashboard with unread counts, folders, and recent emails |
list_inbox_emails | List emails with account/read-status filtering and optional content preview |
get_mailbox_unread_counts | Unread counts per mailbox or per-account summary |
list_accounts | List all configured Mail accounts |
search_emails | Unified search — subject, sender, body text, dates, attachments, flag status/color, cross-account |
get_email_thread | Conversation thread view |
| Tool | Description |
|---|---|
list_mailboxes | Folder hierarchy with message counts |
create_mailbox | Create new mailboxes (supports nested paths) |
move_email | Move/archive emails with filters (subject, sender, date, read status, dry-run) |
update_email_status | Mark read/unread, flag/unflag (optional flag color) — by filters or message IDs |
manage_trash | Soft delete, permanent delete, empty trash |