Apple Notes Mcp Server

Apple Notes MCP 服务

English | 简体中文

让 Claude 读取和编辑你的 Apple Notes——支持原生格式、表格、附件和 iCloud 同步。

Claude 会像你一样编辑笔记：修改一行或勾选一个复选框，其余内容都会保持原样——包括颜色、字体等。标题、各级标题、列表、检查清单、表格和高亮都是真正的 Apple Notes 样式。Claude 还可以查看笔记中的图片、扫描件和 PDF，并帮你整理文件夹。

**要求：**macOS 26 (Tahoe) 或更高版本、Node.js 24+，以及 Claude Code、Claude Desktop（包括 Cowork 和 Code 会话）或 claude.ai。其他 MCP 客户端也可以使用：它支持 MCP 2026-07-28 和较旧的 initialize 握手（2024-11-05 至 2025-11-25）。

设置

1. 添加到 Claude

Claude Code——在终端中运行：

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

Claude Desktop——添加到 ~/Library/Application Support/Claude/claude_desktop_config.json，然后重启 Claude：

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

claude.ai（网页和移动端）——参见远程访问。

@latest 会自动更新：每次 Claude 启动服务时，npx 都会检查是否有新版本并下载。

2. 授予权限

首次需要时会打开设置窗口（也可以运行 npx -y @ailenshen/apple-notes-mcp@latest setup）。为 Apple Notes MCP 启用以下两个开关：

权限	用途
完全磁盘访问权限	读取你的笔记
自动化 → Notes	将更改同步到 iCloud、移动和删除笔记

只需设置一次——更新后权限仍会保留。

3. 开始使用

直接与 Claude 对话：

• “我这周在笔记中做了哪些更改？”
• “在我的购物清单中勾掉牛奶，再加上鸡蛋”
• “在会议笔记中添加一个‘后续步骤’部分”
• “我的收据笔记里的照片上有什么？”
• “把海南旅行笔记移到 Travel”
• “为 Work 中的每篇笔记写一行描述”
• “将 Old Projects 文件夹归档到 ~/Documents/Archive/old-projects.zip，然后删除它”

它能做什么？

工具	描述
overview	查看文件夹，或查看笔记及其大小和一行描述；可按日期筛选，并按日期或标题排序
search	全文搜索并显示匹配文本
read_note	将笔记作为 Markdown 读取——可按 ID 或标题读取，一次读取多篇，或只读取某个部分
read_attachment	查看笔记中的图片、扫描件、PDF、视频、表格或文件
create_note	根据 Markdown 创建新笔记
edit_note	修改文本、在标题下添加内容，或重写笔记——一次完成多项更改
describe_note	保存一行描述，可同时处理多篇笔记
move_note	将笔记移到其他文件夹，或从“最近删除”中恢复
manage_folder	创建、重命名或删除文件夹；将文件夹导出到磁盘（Markdown + 原始附件，可选导出为 .zip），或连同其中所有内容一起删除
delete_note	移到“最近删除”

Claude 不会覆盖你自己的编辑：如果笔记在 Claude 读取后发生了更改，就会拒绝写入。每篇笔记在更改前都会备份。

Notes 中的 Markdown

Notes 中的样式	Markdown
标题 / 一级标题 / 二级标题	# / ## / ###
项目符号列表、短横线列表、编号列表	* / - / 1.
检查清单	- [ ] / - [x]
引用块、等宽文本	>, ```
粗体、斜体、删除线	**…**, *…*, ~~…~~
下划线、高亮	<u>…</u>, <mark>…</mark>
链接、表格	[text](url), | a | b |

远程访问

该服务通过 stdio 通信。要在 claude.ai 中使用它，请将它置于一个桥接服务后面，由桥接服务将 HTTP 请求转发到 stdio，然后将该 URL 添加为自定义连接器。

从 1.x 升级

版本 2 使用 Swift 重写，@latest 会自动安装此版本。变更如下：

• 需要 macOS 26（Tahoe）。较旧的 Mac 请使用版本 1：npx -y @ailenshen/apple-notes-mcp@1。
• 权限现在归 Apple Notes MCP 应用所有。设置窗口只会打开一次；请打开两个开关。
• 重启 Claude，或重新连接连接器一次。
• --http 模式已移除；请参阅远程访问。如需保留此模式，请继续使用 @1。

工作原理

• 读取通过 Notes 自带的数据框架进行，只读。
• 写入只会通过 Notes 自带的编辑对象修改有差异的部分，因此笔记的其余内容（包括 Markdown 无法显示的格式）不会受到影响。
• 同步：每次更改后，都会让 Notes 将其上传到 iCloud。
• Notes 不会切换到前台，也不会弹出对话框。

已知限制

• 可以读取附件，但无法添加或移除附件。
• 目前无法移动文件夹。
• 无法读取锁定的笔记；导出时会将其列为未导出。共享笔记可以编辑，但不能删除。
• 在 Notes 中刚编辑过的表格会在 Claude 修改时重建，从而重置单元格内的格式。

愿景

Apple Notes 是在 Apple 设备上保存个人知识最自然的地方——它可以在各处同步、运行快速，而且注重隐私。但它是一个没有 API 的封闭生态。

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

许可证

MIT