# che-apple-mail-mcp

This MCP server connects an AI agent to Apple Mail for SQLite-backed search, .emlx parsing, attachment work, and batch email operations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 10
- Author: PsychQuant
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PsychQuant/che-apple-mail-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/che-apple-mail-mcp

## What it does

che-apple-mail-mcp lets an agent work with Apple Mail through MCP. It searches by subject, sender, recipient, and date, reads raw headers and message content, handles attachments, and manages mailboxes. The server uses a native Swift binary, an SQLite search path, and an `.emlx` parser.

The Claude Code plugin also ships the `/archive-mail` command family, confirmation rules for destructive actions, and a hook that checks for a stale binary. Full Disk Access is required for the fast SQLite path and `batch_export_emails_markdown`; without it, the server may read little or nothing. An MCP-only build uses Swift 5.9, and a self-built binary may lose TCC permissions after rebuilds unless it has a Developer ID signature.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- search emails by sender, subject, or date
- inspect raw headers and message bodies
- export a group of emails to Markdown
- manage mailboxes, rules, and signatures

## Example prompts
- Find messages from `alice@example.com` on the requested date and show their subjects.
- Export the matching messages with `batch_export_emails_markdown`.
- Inspect the email attachments and save the requested file.

## Similar
- [apple-mail](https://affpapa.org/en/nevibecode/skills/apple-mail.md) — skill · 1400 installs
- [Apple Mail MCP](https://affpapa.org/en/nevibecode/mcp/apple-mail-mcp.md) — MCP server · ★ 74
- [apple-mail-mcp](https://affpapa.org/en/nevibecode/mcp/parasxos-apple-mail-mcp.md) — MCP server · ★ 33
- [Apple Mail](https://affpapa.org/en/nevibecode/mcp/apple-mail.md) — MCP server · ★ 31
- [Atomic Mail](https://affpapa.org/en/nevibecode/mcp/atomic-mail.md) — MCP server · ★ 264
- [your-mail-mcp](https://affpapa.org/en/nevibecode/mcp/your-mail-mcp.md) — MCP server · ★ 18

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md