用途:让 Claude 等 AI 助手直接读取与编辑 macOS 上的 Apple Notes,把备忘录变成可被 AI 访问、可读可写的数据源。
主要能力:支持备忘录的列出、搜索与增删改查;支持标题、标题层级、列表、清单、表格、高亮等 Apple Notes 原生格式;可读取笔记中的图片、扫描件与 PDF;写入只修改差异部分,不覆盖用户自己的编辑(若笔记在读取后被改动则拒绝写入),每次改动前自动备份;改动后请求 Notes 上传至 iCloud;运行时不弹出对话框、不将 Notes 置于前台。
使用方式:需安装 Node.js 24+,并要求 macOS 26(Tahoe)或更高版本。Claude Code 在终端运行安装命令;Claude Desktop 需在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加配置并重启;claude.ai 需通过将 HTTP 请求转发到 stdio 的桥接方式配置自定义连接器。首次使用会打开设置窗口,为 Apple Notes MCP 打开两个权限开关,权限在更新后仍保留。也可手动运行 npx -y @ailenshen/apple-notes-mcp@latest setup。服务器通过 stdio 通信,支持 MCP 2026-07-28 及 2024-11-05 至 2025-11-25 的旧版初始化握手,也兼容其他 MCP 客户端。升级后 @latest 会自动更新版本。
限制:附件只能读取,不能添加或删除;暂不支持移动文件夹;锁定的笔记无法读取;共享笔记可编辑但不可删除;在 Notes 中刚编辑过的表格被 Claude 修改后会被重建,单元格内格式会重置;旧版 macOS 只能使用 npx -y @ailenshen/apple-notes-mcp@1,该版本保留 --http 模式。