Provides comprehensive Apple Mail integration with tools for managing emails, accounts, and mailboxes - including reading, searching, sending, marking as read, and deleting emails across configured accounts.
MCP Apple Mail
Clean Apple Mail integration for Model Context Protocol (MCP) using JXA (JavaScript for Automation).
Features
✨ No String Parsing - Uses JXA to return native JavaScript objects 🎯 Type-Safe - Full TypeScript support with interfaces 📧 Complete Mail Support - Read, search, send, manage emails 🔐 Account-Specific Sending - Send from any configured account 📁 Hierarchical Mailboxes - Full mailbox tree structure support
Installation
Usage with Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
Available Tools
mail_get_accounts
Get all configured email accounts.
mail_get_mailboxes
Get mailbox hierarchy for a specific account.
mail_get_unread
Get unread emails (with configurable limit).
mail_search
Search emails by text content.
mail_get_latest
Get latest emails from a specific account.
mail_send
Send email from a specific account.
mail_mark_read
Mark emails as read by ID.
mail_delete
Delete emails by ID.
Technical Details
JXA Implementation
This implementation uses JavaScript for Automation (JXA) instead of traditional AppleScript, which provides:
- Direct JavaScript object returns (no parsing!)
- Clean error handling
- Type safety with TypeScript
- ISO date formats
- Proper arrays and nested structures
Example Response
Development
Requirements
- macOS (for Apple Mail access)
- Node.js or Bun
- Apple Mail configured with at least one account
License
MIT
Credits
Clean implementation without string parsing, built with JXA for maximum reliability and performance.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables integration with Apple Mail on macOS using JavaScript for Automation (JXA). Supports reading, searching, sending, and managing emails across multiple accounts with full mailbox hierarchy support.