Apple Notes MCP 服务器

读取和写入 Apple Notes，支持 Apple Notes 原生格式。

大多数 Apple Notes MCP 服务器只能写入纯文本。本服务器可以创建原生格式的笔记——标题、字号、粗体、列表等都会渲染为真正的 Apple Notes 样式，而非纯文本。这是通过利用 Notes.app 内置的 Markdown 导入功能实现的。

要求： macOS 26 (Tahoe) 或更高版本，Node.js 24+

设置

1. 添加到你的 MCP 客户端

Claude Desktop — 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@ailenshen/apple-notes-mcp@latest"]
    }
  }
}

Claude Code — 在终端运行：

claude mcp add apple-notes -- npx -y @ailenshen/apple-notes-mcp@latest

2. 授予权限

为了支持原生格式，服务器使用了 Notes.app 内置的 Markdown 导入功能——它会用 Notes.app 打开 .md 文件并自动确认导入对话框。这需要为 node 授予两个 macOS 权限：

首次使用时，macOS 会提示你批准——只需点击“允许”。如果你错过了提示，请前往上述设置手动开启 node。授予权限后，重启你的 MCP 客户端。

如果缺少权限，服务器会明确告知你缺少哪一项以及如何修复。

3. 开始使用

像平时一样与 AI 对话即可：

• “列出我在 Projects 文件夹中的所有笔记”

• “在我的笔记中搜索‘会议议程’”

• “读取我的购物清单笔记”

• “在 Work 中创建一个包含今日待办事项的笔记”

• “用这些新项目更新我的购物清单”

• “删除名为‘旧草稿’的笔记”

它能做什么？

Notes 中的 Markdown 支持

远程访问（HTTP 模式）

想要从手机或其他电脑访问你的 Apple Notes 吗？

npx @ailenshen/apple-notes-mcp@latest --http

这将打印一个带有内置密钥的端点 URL：

Endpoint: http://localhost:3100/mcp/a3f8b2c9e1d4...

将你的远程 MCP 客户端指向此 URL。若要通过互联网访问，请使用隧道（ngrok、Cloudflare Tunnel 等）将其置于 HTTPS 之后。

若要使其在重启后保持运行，请参阅 wiki 中的 LaunchAgent 示例。

工作原理

• 读取：通过 SQLite 直接查询笔记数据库——快速且安全。内容通过 turndown 从 Apple 的 HTML 转换为 Markdown。

• 创建：使用 macOS 原生的 Markdown 导入功能 (open -a Notes)，因此原生保留了格式。创建过程中 Notes.app 会短暂出现（约 0.5 秒）。

• 更新：删除旧笔记并创建一个新笔记，自动保留原始文件夹。

• 删除：将笔记移至“最近删除”，与手动操作相同。

已知限制

• 不支持部分笔记编辑（例如“只修改这一段”）。update_note 总是替换全部内容。这是 Notes 暴露内容方式的根本限制——其 AppleScript 接口返回的是 HTML 而非原始 Markdown，因此目前无法实现干净的“读取→编辑→写入”循环。

• 创建笔记时 Notes 会短暂出现。Markdown 导入流程需要在 Notes.app 中自动确认对话框，这可能会使其瞬间置于前台。

如果 Apple 在 AppleScript 中添加 Markdown 导入/导出功能，或开放官方 Notes API，这些限制将会解除——目前这两个方向都在关注未来的 macOS 版本。

愿景

Apple Notes 是在 Apple 设备上保存个人知识最自然的地方——它随处同步、快速且私密。但它是一个没有 API 的封闭花园。

本项目使 Apple Notes 成为 AI 的一流数据源。长期目标是：无论你在哪里与 AI 对话——在 Mac 上、手机上还是网页上——你的 Apple Notes 始终是可访问、可读且可写的。

许可证

MIT