apple-mail-mcp — Claude Code MCP server for Apple Mail
Connects an agent to Apple Mail to search and read messages, sort mail, create drafts, and send email. It runs locally on macOS.
claude mcp add apple-mail-mcp -- uvx apple-mailbox-mcpWhat apple-mail-mcp does
Search messages by sender, date, mailbox, read status, or attachments, then read their full text and reconstruct conversations. For mail triage, the server prepares a plan for review before applying changes and checks the outcome against Mail afterward. Sending requires an explicit tool call; deleting moves a message to Mail’s Trash.
The server runs locally with Apple Mail on a Mac. For Exchange, it can retrieve message bodies from the server, create drafts in Exchange Drafts, and schedule server-side delivery. Other providers use a local background sender for scheduled messages, so the Mac needs to be on for that process to run. To connect it to Claude Code, run claude mcp add parasxos-apple-mail-mcp -- uvx apple-mailbox-mcp.
What it helps with
- find messages by sender, date, or body text
- reconstruct a conversation from matching messages
- review a mail-sorting plan before applying it
- create a draft in Exchange Drafts
- send a message from the intended Apple Mail account
Example prompts for the agent
- Find messages from Maria about the memo last week and show the full conversation.
- Prepare a plan to move the newsletters into a folder, and let me review it before applying changes.
- Create a draft in Exchange Drafts and send the message from my work account.
How to install apple-mail-mcp
Platform CLI
claude mcp add apple-mail-mcp -- uvx apple-mailbox-mcpuvx runs the command named after the package; if the README names another one, use uvx --from apple-mailbox-mcp <command>
Platform CLI
codex mcp add parasxos-apple-mail-mcp -- uvx apple-mailbox-mcpuvx runs the command named after the package; if the README names another one, use uvx --from apple-mailbox-mcp <command>
Config file
{
"mcpServers": {
"parasxos-apple-mail-mcp": {
"command": "uvx",
"args": [
"apple-mailbox-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from apple-mailbox-mcp <command>
Config file
{
"servers": {
"parasxos-apple-mail-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-mailbox-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from apple-mailbox-mcp <command>
Platform CLI
gemini mcp add parasxos-apple-mail-mcp uvx apple-mailbox-mcpuvx runs the command named after the package; if the README names another one, use uvx --from apple-mailbox-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about apple-mail-mcp
How do I install apple-mail-mcp in Claude Code?
Run claude mcp add parasxos-apple-mail-mcp -- uvx apple-mailbox-mcp to add the server through uvx.
What does apple-mail-mcp do?
It connects an agent to Apple Mail for searching and reading messages, sorting mail, creating drafts, and sending email.
What does apple-mail-mcp need to run?
It needs a Mac running macOS with Apple Mail. Scheduled delivery through the local sender depends on the Mac being on; Exchange can deliver scheduled messages server-side.
