Provides comprehensive integration with Apple Mail, enabling AI assistants to read, search, organize, compose, and manage emails directly through natural language commands. Supports advanced email operations including threading, attachment handling, folder management, and email analytics.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apple Mail MCP Serverfind emails from John about the Alpha project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apple Mail MCP Server
Star History
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.
Quick Start
Prerequisites: macOS with Apple Mail configured, Python 3.7+
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
Restart Claude Desktop and grant Mail.app permissions when prompted.
Tip: An
.mcpbbundle is also available on the Releases page for one-click install in Claude Desktop.
Tools (26)
Reading & Search
Tool | Description |
| Dashboard with unread counts, folders, and recent emails |
| List emails with account/read-status filtering |
| Search emails with full content preview |
| Unread count per account |
| List all configured Mail accounts |
| Recent emails from a specific account |
| Recent emails from a sender with time-range filters |
| Advanced multi-criteria search (subject, sender, dates, attachments) |
| Find all emails from a specific sender |
| Full-text search in email bodies |
| Cross-account unified search |
| Detect newsletter and subscription emails |
| Conversation thread view |
Organization
Tool | Description |
| Folder hierarchy with message counts |
| Move emails between folders (supports nested paths) |
| Batch mark read/unread, flag/unflag |
| Soft delete, permanent delete, empty trash |
Composition
Tool | Description |
| Send new emails (TO, CC, BCC) |
| Reply or reply-all with optional CC/BCC |
| Forward with optional message, CC/BCC |
| Create, list, send, and delete drafts |
Attachments
Tool | Description |
| List attachments with names and sizes |
| Save attachments to disk |
Analytics & Export
Tool | Description |
| Email analytics (volume, top senders, read ratios) |
| Export single emails or mailboxes to TXT/HTML |
| Interactive UI dashboard (requires mcp-ui-server) |
Configuration
User Preferences (Optional)
Set the USER_EMAIL_PREFERENCES environment variable to give the assistant context about your workflow:
For .mcpb installs, configure this in Claude Desktop under Developer > MCP Servers > Apple Mail MCP.
Safety Limits
Batch operations have conservative defaults to prevent accidental bulk actions:
Operation | Default Limit |
| 10 emails |
| 5 emails |
| 1 email |
Override via function parameters when needed.
Usage Examples
Email Management Skill
A companion Claude Code Skill is included that teaches Claude expert email workflows (Inbox Zero, daily triage, folder organization). Install it alongside the MCP for intelligent, multi-step email management:
See skill-email-management/README.md for details.
Requirements
macOS with Apple Mail configured
Python 3.7+
fastmcp(+ optionalmcp-ui-serverfor dashboard)Claude Desktop or any MCP-compatible client
Mail.app permissions: Automation + Mail Data Access (grant in System Settings > Privacy & Security > Automation)
Troubleshooting
Issue | Fix |
Mail.app not responding | Ensure Mail.app is running; check Automation permissions in System Settings |
Slow searches | Set |
Mailbox not found | Use exact folder names; nested folders use |
Permission errors | Grant access in System Settings > Privacy & Security > Automation |
Project Structure
Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/my-feature)Commit and push
Open a Pull Request
License
MIT -- see LICENSE.