Apple Mail
Search, read, draft and send mail through Apple Mail on macOS, with safety profiles
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.1.7
- Listing updated
- today
Similar MCP servers
About Apple Mail
Apple Mail is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Apple Mail MCP drives the native Mail app so an agent can list mailboxes, search and read messages and threads, create drafts, reply, forward, mark, move, delete and archive. Mail stays the system of record.
Three profiles control risk: safe_readonly, safe_manage (the default for uvx and clone installs, which saves replies and forwards as unsent drafts and sends nothing) and full_access, which can send. The Claude Desktop bundle defaults to full_access. Deleting or archiving works in safe_manage, and blocked tools return an error naming the setting to change.
It runs locally over stdio via uvx apple-mcp-mail, with health and permission-check tools.
Install
Run in a terminal
claude mcp add apple-mcp-mail -- uvx apple-mcp-mailAdd to claude_desktop_config.json
{
"mcpServers": {
"apple-mcp-mail": {
"command": "uvx",
"args": [
"apple-mcp-mail"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"apple-mcp-mail": {
"command": "uvx",
"args": [
"apple-mcp-mail"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"apple-mcp-mail": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-mcp-mail"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"apple-mcp-mail": {
"command": "uvx",
"args": [
"apple-mcp-mail"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"apple-mcp-mail": {
"command": "uvx",
"args": [
"apple-mcp-mail"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
APPLE_MAIL_MCP_SAFETY_PROFILESafety mode for Mail operations: safe_readonly, safe_manage, or full_access.APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOTDirectory attachments may be saved to or attached from. Unset disables attachment file access.APPLE_MAIL_MCP_VISIBLE_DRAFTSWhether drafts stay open in a Mail window. false saves them to the Drafts mailbox and leaves no window open.
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- mail_health
- Checks health.
- mail_list_mailboxes
- Lists mailboxes.
- mail_search_messages
- Searches messages.
- mail_get_message
- Gets a message.
- mail_get_thread
- Gets a thread.
- mail_compose_draft
- Composes a draft.
- mail_send_message
- Sends a message.
- mail_reply_message
- Replies to a message.
- mail_forward_message
- Forwards a message.
- mail_move_message
- Moves a message.
- mail_delete_message
- Deletes a message.
- mail_archive_thread
- Archives a thread.
What it does
- Mailbox search
- Search and read messages.
- Thread helpers
- Get, reply to and archive threads.
- Draft first
- safe_manage saves drafts instead of sending.
- Full access
- Optionally send directly.
- Visible drafts
- Option to open drafts in Mail.
- Permission tools
- Health and recovery helpers.
Good for
- Draft replies for review
- Find a message in a thread
- Archive a thread
- Triage unread mail
Pricing
Open source
Free; runs locally
Apple Mail FAQ
Does it send mail by default?
Not in safe_manage; send needs full_access.
Install?
uvx apple-mcp-mail.
Bundle default?
full_access.
Is Apple Mail free?
Yes. Apple Mail is open source, so you can use and self-host it for free.
How do I add Apple Mail to Claude Code?
Run this command in your terminal: claude mcp add apple-mcp-mail -- uvx apple-mcp-mail
What are the best alternatives to Apple Mail?
The closest alternatives to Apple Mail are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

