Apple Mail (alt)
MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails via natural language
What is Apple Mail (alt)?
Apple Mail (alt) is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server giving ai assistants full access to apple mail - read, search, compose, organize & analyze emails via natural language
MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails via natural language
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server giving AI assistants full access to Apple Mail -
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx apple-mailConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Apple Mail (alt)
The Apple Mail MCP Server gives AI assistants like Claude full programmatic access to the Apple Mail app on macOS via AppleScript, exposing 22 tools that cover reading, searching, composing, replying, forwarding, organizing, and analyzing emails across all configured accounts. It works with any macOS mail accounts managed by Apple Mail, including iCloud, Gmail, Exchange, and IMAP accounts, without requiring any cloud API keys. Developers and power users install it to manage their inbox through natural language—triage messages, draft replies, move emails, and get inbox analytics without switching apps.
Prerequisites
- macOS with Apple Mail configured and at least one email account set up
- Python 3.10+ and either uvx or pip
- Claude Desktop or Claude Code as your MCP client
- macOS Accessibility and Automation permissions granted to the terminal running the server
Install the package via uvx (recommended)
The simplest installation method uses uvx to run the server without a permanent install. Register it directly with Claude Code.
claude mcp add apple-mail -- uvx mcp-apple-mailAlternative: install via pip
If you prefer a traditional pip install, install the package globally and then register it with Claude.
pip install mcp-apple-mail
claude mcp add apple-mail -- mcp-apple-mailGrant macOS Automation permissions
The server controls Apple Mail via AppleScript. Go to System Settings > Privacy & Security > Automation and enable the permission for your terminal application (Terminal, iTerm2, or the Claude Desktop app) to control Mail.
Add the server to Claude Desktop config
For Claude Desktop, add this entry to your claude_desktop_config.json. Include optional USER_EMAIL_PREFERENCES to customize default behavior.
{
"mcpServers": {
"apple-mail": {
"command": "uvx",
"args": ["mcp-apple-mail"],
"env": {
"USER_EMAIL_PREFERENCES": "Show max 50 emails, prefer Archive folders"
}
}
}
}Enable read-only mode if desired
If you want to prevent the AI from sending or composing emails, add the --read-only flag. This disables all composition and sending tools.
claude mcp add apple-mail -- uvx mcp-apple-mail --read-onlyApple Mail (alt) Examples
Client configuration
Claude Desktop configuration for the Apple Mail MCP server with user preferences set via environment variable.
{
"mcpServers": {
"apple-mail": {
"command": "uvx",
"args": ["mcp-apple-mail"],
"env": {
"USER_EMAIL_PREFERENCES": "Default to work account, show max 50 emails, prefer Archive folders"
}
}
}
}Prompts to try
Once connected, you can manage your entire Apple Mail inbox through these natural language prompts.
- "Show me an overview of my inbox"
- "Search for emails about project deadline in the last 7 days"
- "Reply to the latest email from Alice with: Thanks, I'll follow up tomorrow"
- "Move all emails with invoice in the subject to my Archive folder"
- "Who are my top 5 email senders this month?"
- "Show me all emails awaiting my reply"Troubleshooting Apple Mail (alt)
AppleScript errors or 'not authorized' messages when running tools
Open System Settings > Privacy & Security > Automation and make sure the terminal or app running the MCP server has permission to control Mail.app. You may also need to grant Accessibility access.
Server cannot find emails or mailboxes that exist in Apple Mail
Ensure Apple Mail is open and fully synced before using the server. AppleScript requires Mail to be running. Also verify that the target mailbox name in your prompt matches exactly what appears in the Mail sidebar.
uvx command not found
Install uv with 'curl -LsSf https://astral.sh/uv/install.sh | sh', then reopen your terminal. uvx is bundled with uv.
Frequently Asked Questions about Apple Mail (alt)
What is Apple Mail (alt)?
Apple Mail (alt) is a Model Context Protocol (MCP) server that mcp server giving ai assistants full access to apple mail - read, search, compose, organize & analyze emails via natural language It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Apple Mail (alt)?
Follow the installation instructions on the Apple Mail (alt) GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Apple Mail (alt)?
Apple Mail (alt) works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Apple Mail (alt) free to use?
Yes, Apple Mail (alt) is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Apple Mail (alt) Alternatives — Similar Communication Servers
Looking for alternatives to Apple Mail (alt)? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Apple Mail (alt) in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Apple Mail (alt)?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.