An MCP server that gives AI assistants access to Apple Mail on macOS via AppleScript.
npx @griches/apple-mail-mcp| Tool | Description |
|---|---|
list_mailboxes |
List all mailboxes across accounts with unread counts |
list_messages |
List recent messages in a mailbox, optionally filtered to unread only |
get_message |
Get the full content of an email by ID |
search_messages |
Search emails by subject or sender across mailboxes |
send_email |
Send an email with optional CC/BCC (supports multiple recipients) |
get_unread_count |
Get unread count for a mailbox or all mailboxes |
move_message |
Move an email to a different mailbox |
mark_read |
Mark an email as read or unread |
delete_message |
Delete an email (moves to trash) |
flag_message |
Flag or unflag an email message |
claude mcp add apple-mail -- npx @griches/apple-mail-mcpAdd to your claude_desktop_config.json:
{
"mcpServers": {
"apple-mail": {
"command": "npx",
"args": ["@griches/apple-mail-mcp"]
}
}
}- macOS (uses AppleScript)
- Node.js 18+
MIT — see the main repository for full details.