The JXA Mail MCP server provides fast programmatic access to Apple Mail on macOS through 7 tools, enabling email management, search, and automation via the Model Context Protocol.

Core Capabilities:

• Account & Mailbox Management - List all configured email accounts and their mailboxes with unread counts

• Email Retrieval - Fetch emails with standard properties (ID, subject, sender, date, read/flagged status) with filters for all emails, today's emails, unread emails, or flagged emails from specific accounts/mailboxes

• Search & Discovery - Search emails by query string across subject and sender fields (case-insensitive), with optional FTS5 full-text search index for body content searches

Performance Optimizations:

• 87x faster email retrieval using JXA batch property fetching vs. traditional per-message iteration

• 700-3500x faster body search (~2ms vs ~7s) with optional SQLite FTS5 search index

• Real-time index updates via --watch flag for automatic synchronization when new emails arrive

• Fast startup times (<5s) using disk-first sync approach

Configuration & Security:

• Customizable via environment variables for default accounts, mailboxes, index location, and email limits

• Built-in protections against SQL injection, JXA injection, XSS, DoS attacks, and path traversal

• Works with Claude Desktop and other MCP-compatible tools through natural conversation

Enables programmatic interaction with Apple Mail on macOS, allowing for listing accounts and mailboxes, fetching recent, unread, or flagged emails, and searching for messages by sender or subject.

Allows for managing and retrieving email content from iCloud accounts configured within the Apple Mail application.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Apple Mail MCP Show me my unread emails from today"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.