@griches/apple-mail-mcp
v1.0.0
Published
MCP server for interacting with Apple Mail on macOS
Downloads
79
Maintainers
Readme
@griches/apple-mail-mcp
An MCP server that gives AI assistants access to Apple Mail on macOS via AppleScript.
Quick Start
npx @griches/apple-mail-mcpTools
| Tool | Description |
|------|-------------|
| list_mailboxes | List all mailboxes across accounts with unread counts |
| list_messages | List recent messages in a mailbox |
| 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 |
Configuration
Claude Code
claude mcp add apple-mail -- npx @griches/apple-mail-mcpClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"apple-mail": {
"command": "npx",
"args": ["@griches/apple-mail-mcp"]
}
}
}Requirements
- macOS (uses AppleScript)
- Node.js 18+
License
MIT — see the main repository for full details.
