apple-mail-mcp 是一个 Apple Mail 的 MCP（Model Context Protocol）服务器，定位是解决大型邮箱场景下的邮件读取与搜索问题。官方介绍称其为“唯一具备全覆盖正文搜索的 Apple Mail MCP 服务器”，在基于 AppleScript 的服务器会超时的大邮箱上依然可靠。
用途与定位 该项目用于让 AI 客户端（如 Claude Code、Claude Desktop）接入本地 Apple Mail，读取、搜索和提取邮件内容。它提供 8 个工具，覆盖读取、搜索与附件提取等操作。
主要能力
- 列出账户与邮箱：通过直接读取 Envelope-Index SQLite 实现，官方称约 1ms 完成 list_accounts，约 5ms 完成 50 封邮件列表，JXA 作为正确性回退。
- 获取邮件：采用磁盘优先的 .emlx 读取方式，无需 JXA 往返，官方称单封邮件读取约 3ms。
- 全文搜索：基于 FTS5 索引，覆盖整个邮箱；官方称主题搜索约 7ms。作者在真实的约 73,000 封邮件邮箱上与另外 6 个 Apple Mail MCP 服务器做过对比，称多数竞品不支持正文搜索，唯一支持的（BastianZim）仅实时扫描最近 5000 封，较旧邮件会静默遗漏，而本项目的 FTS5 索引覆盖全邮箱。
- 附件提取：可提取附件。
使用方式
- 安装途径一：Claude Code 插件。
- 安装途径二：Claude Desktop 一键包，从最新 release 下载 apple-mail-mcp-<version>.mcpb 后双击即可。插件与一键包都通过轻量启动器（uvx → pipx → 私有 venv，取可用者）运行已发布的 PyPI 包，不附带 vendored 代码，行为与手动安装一致。两者以 --watch 启动服务器；需给启动应用（Claude Code / Claude Desktop）授予 Full Disk Access，以保证索引保持最新。
- 加入 MCP 客户端（具体配置见文档）。
- 建议步骤：构建搜索索引（Recommended）；可选配置：运行后写入带注释的配置文件，可编辑设置默认主账户或邮箱；每个键都有对应的 APPLE_MAIL_* 环境变量，便于用环境变量配置。配置优先级为 CLI > env > 文件 > 默认。
- 所有工具同时提供独立 CLI 命令，无需运行 MCP 服务器，所有命令输出 JSON。可生成面向 CLI 访问的 Claude Code skill。
适用场景 需要在 AI 客户端中检索、阅读和提取本地 Apple Mail 邮件，尤其是邮箱规模较大、基于 AppleScript 的方案会超时或遗漏旧邮件的场景。
限制与注意事项 官方描述强调其在 73K 邮箱上的可靠性与速度优势；使用插件或一键包时需授予 Full Disk Access，否则索引可能无法保持最新。附件提取、账户/邮箱操作的具体参数与输出结构暂未提供。项目许可为 GPL-3.0-or-later。价格与收费信息原文未提供。
