Apple Mail MCP
About
Apple Mail MCP server with full-coverage FTS5 body search. Reliable on large mailboxes where AppleScript-based servers timeout.
Details
- Author
- imdinu
- GitHub stars
- 47
- Downloads
- 500
- Categories
- Communication, Automation, Productivity, Other, Search
Jump to
- Full-coverage body search via FTS5 index
- 8 tools: list accounts, mailboxes, get emails, search, extract links and attachments
- ~3ms single email fetch via disk-first .emlx reading
- ~1ms list accounts and ~5ms 50-email listing via direct SQLite reads
- Reliable on large mailboxes (tested on ~73K messages)
- CLI commands for all tools (JSON output)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Apple Mail MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install with pipx install apple-mail-mcp, then add the server to your MCP client configuration with the command apple-mail-mcp. Optionally build the search index with apple-mail-mcp index --verbose (requires Full Disk Access for Terminal). Customize defaults by running apple-mail-mcp init to generate a config file, or use APPLE_MAIL_* environment variables. All tools are also available as standalone CLI commands (e.g., apple-mail-mcp search "query").
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"apple mail mcp": {
"apple-mail-mcp": {
"command": "apple-mail-mcp"
}
}
}
}McpServers
{
"apple-mail-mcp": {
"command": "apple-mail-mcp"
}
}Apple Mail MCP
<!-- mcp-name: io.github.imdinu/apple-mail-mcp -->
<p align="center">
</p>
The only Apple Mail MCP server with full-coverage body search — reliable on large mailboxes where AppleScript-based servers timeout. 8 tools for reading, searching, and extracting email content.
Read the docs for the full guide.
Quick Start
pipx install apple-mail-mcp
Add to your MCP client:
{
"mcpServers": {
"mail": {
"command": "apple-mail-mcp"
}
}
}
Build the Search Index (Recommended)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
