Apple Mail, Calendar & Notes

Apple Mail、Calendar 和 Notes MCP

让你的 AI 助手读取、搜索、整理和发送邮件，管理日历并记录笔记——
使用 Mac 上现有的 Mail、Calendar 和 Notes 应用。适用于任何 MCP 客户端。

下载最新版本 · 安装 · 功能介绍 · 常见问题

为什么要开发它

大多数 AI 邮件连接器都在云端运行，且只支持 Gmail 或 Outlook。如果你的邮件使用 Apple Mail——自托管的 IMAP 服务、iCloud 或公司账户——就没有简便的方法让助手访问邮件。

这个 MCP 服务会直接与 Mac 上的应用通信。这意味着：

• 适用于任何 MCP 客户端。 桌面聊天应用、本地模型应用、编码 Agent——任何能通过 stdio 启动 MCP 服务的应用都可以。
• Apple Mail 能打开的任何账户都可以使用。 自托管、iCloud、Exchange、通过 IMAP 使用的 Gmail——只要账户在 Mail.app 中，你的助手就能查看。
• 无需安装任何东西。 无需 Node、Python 或 Homebrew。它使用 JavaScript for Automation 运行，这是每台 Mac 都自带的。
• 邮件会留在 Mac 上。 服务不包含网络代码。助手只能看到它请求的内容；这些内容之后会去往何处取决于你使用的模型（本地模型会将所有内容保留在 Mac 上）。
• 只需两次权限提示，而非三十次。 所有操作都归入 read 工具和 write 工具。批准一次 read，之后就不用再管。
• 也适用于较小的本地模型。 参数要求宽松（"true"、"3 days ago"，可用 folder 代替 mailbox），每次出错都会返回一条直白的“如何修复”说明，而不是让你束手无策。

功能介绍

用日常语言提问——“有哪些邮件在等我回复？”、“把打印机发票转发给财务部”、“周二下午 1 点安排和 Sam 通话”、“保存合同邮件里的 PDF”。它在后台可以：

📥 整理邮件 — “哪些邮件需要我处理？”

🔎 阅读和搜索

✉️ 写邮件

🗂 整理

📅 日历

📝 备忘录

安装

你需要 macOS 14 或更高版本（较旧版本可能也能使用，但未经测试）以及一个 MCP 客户端。

适用于任意 MCP 客户端

获取代码——运行 git clone https://github.com/ipsupport-llc/apple-mail-mcp，或解压从最新版本下载的 .mcpb 文件——然后将服务添加到客户端的配置中。它会在 Mac 自带的 osascript 上运行：

{
  "mcpServers": {
    "apple-mail": {
      "command": "/usr/bin/osascript",
      "args": ["-l", "JavaScript", "/path/to/apple-mail-mcp/server/apple-mail-mcp.js"]
    }
  }
}

运行 ./install.sh --print 会输出包含正确路径的此配置块。该服务也已在 MCP Registry 中列出，名称为 io.github.ipsupport-llc/apple-mail-mcp。

助手首次访问 Mail、Calendar 或 Notes 时，macOS 会询问是否允许客户端控制这些应用——点击 允许。

Claude Desktop（一键安装）

1. 从最新版本下载 apple-mail-mcp.mcpb。
2. 双击该文件并点击 安装。

更新、设置和卸载选项位于 设置 → 扩展。

设置

在服务的 env 中设置环境变量（Claude Desktop：设置 → 扩展 → Apple Mail, Calendar & Notes → 配置）：

工具权限

大多数客户端会在使用工具前征求许可。我们建议允许一次 read，并在每次使用时批准 write，这样你始终能看到哪些内容将被发送、移动或删除。

安全性

• 邮件和备忘录绝不会被永久删除。 邮件会移至账户的废纸篓，备忘录会移至“最近删除”。如果无法这样处理——例如账户没有废纸篓、备忘录账户没有“最近删除”（如 Exchange）、内容已在废纸篓中，或备忘录已锁定——扩展程序会拒绝操作并说明原因。只有在每个账户都会将已删除邮件保留在废纸篓中时，才允许使用会删除邮件的邮件规则。
• macOS 中的日历事件和规则没有废纸篓。 删除时会返回其完整副本，因此之后可以按需重新创建。
• 回复和转发默认保存为草稿。 你可以在 Mail 中查看内容，然后自行按下 Send。dry_run: true 会准确显示将要发送的内容——收件人（包括 Reply-To 和回复所有人）、主题和全文——如果 Mail 实际要使用的收件人与之不同，则不会发送回复。发送结果会列出 Mail 实际发送的内容。
• 不会卡住。 Mail、Calendar 和 Notes 由独立的工作进程驱动：超时前未完成的调用会被停止并返回明确错误，ping 和 tools/list 始终会响应，已取消的调用也确实会停止。超时的写入操作不会盲目重试。每次调用都会将应用名称和耗时记录到 stderr。
• 说明权限问题。 如果缺少自动化权限、应用未运行或连接中断，系统会提供通俗易懂的“如何修复”说明，而不是错误代码。
• 避免意外重复操作。 15 分钟内重复执行相同的发送、回复、删除或创建调用会被拒绝——这样卡住的模型就不会把同一封邮件发五次。
• 仅在明确要求时删除重复事件。 删除重复事件会移除整个系列，因此扩展程序会要求提供 whole_series: true。
• 试运行。 批量移动和删除可以先预览，再执行。
• 附件集中存放。 附件只会保存到设置中的附件文件夹内，且绝不会覆盖现有文件——如果文件已存在，会在文件名后追加 (1)、(2)……。要附加到外发邮件的文件也只能来自该文件夹，因此会拒绝“附加 ~/.ssh/id_rsa”这类请求；来自其他工具的文件（例如从 Seafile 下载的文件）需先放入该文件夹。
• 会检查附件。 如果 Mail 未接收所有文件，则不会发送邮件，而是将其作为草稿打开。
• 警惕邮件中隐藏的指令。 助手读取的所有内容都会成为其上下文的一部分，恶意邮件可能会试图指示助手执行某些操作。如果你对此有所顾虑，请将 write 设为需要手动批准，或开启只读模式。
• 单个易读文件。 整个服务端代码都在 server/apple-mail-mcp.js 中，没有依赖项，也不会发起网络调用。

常见问题

Mac 处于睡眠状态时，Mail 规则会运行吗？ 不会。Apple Mail 规则只会在 Mail 打开时运行，而且只处理新邮件。要整理旧邮件，请让助手移动它们。如果你的邮件服务器支持 Sieve，服务器端过滤器在不同设备上的表现会更可靠。

助手无法读取某条备忘录。 它很可能已被锁定。请先在 Notes 中解锁；锁定的备忘录会保持私密。

搜索速度很慢。 Apple Mail 的脚本处理大型文件夹时速度较慢，而搜索邮件正文最慢。请将搜索范围缩小到特定账户、文件夹或日期范围。

看不到这些工具。 请检查客户端中是否已启用该服务端，然后重启客户端。./test.sh 会直接与服务端通信，不需要任何客户端。（Claude Desktop：Settings → Extensions；日志位于 ~/Library/Logs/Claude/。）

“Not authorized to send Apple events”。 打开 System Settings → Privacy & Security → Automation，允许你的 MCP 客户端（启动该服务端的应用）控制 Mail、Calendar 和 Notes。

git clone https://github.com/ipsupport-llc/apple-mail-mcp.git ~/code/apple-mail-mcp
cd ~/code/apple-mail-mcp
./install.sh --print   # any client: prints the config block to paste
./install.sh     # Claude Desktop: adds an "apple-mail" entry to claude_desktop_config.json (backs it up first)
./test.sh        # talks to the server directly and prints your accounts and calendars
./uninstall.sh   # removes the entry

/usr/bin/osascript -l JavaScript tests/unit.js server/apple-mail-mcp.js
python3 tests/protocol.py

git tag v1.4.0 && git push origin v1.4.0

许可证

MIT © IPSupport LLC。部分功能创意受到 patrickfreyer/apple-mail-mcp（MIT）的启发。