Apple Notes

Apple Notes MCP

适用于 macOS 上 Apple Notes 的 MCP 服务。

提供对笔记和文件夹的访问，用于创建、整理和管理。让 Notes 继续作为系统记录的权威来源，同时支持 Agent 读取、创建、更新、移动和删除笔记。

适用场景

• 仅使用 Notes 的工作流
• 与一体化服务相比，需要更强的隔离
• 通过原生 Notes 应用执行结构化的笔记和文件夹操作

功能

• 列出账户和文件夹
• 列出、搜索和管理笔记（CRUD）
• 创建、重命名和删除文件夹
• 列出笔记附件
• 为上下文受限的客户端提供工具发现辅助项 search_tools 和 get_tool_info
• 提供最近笔记资源和整理提示词
• 健康状态和权限检查：notes_health、notes_permission_guide、notes_recheck_permissions

在这台 Mac 上安装

uvx apple-mcp-notes

git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

在 AI Agent 中安装

{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["apple-mcp-notes"],
      "env": {
        "APPLE_NOTES_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

claude mcp add --transport stdio --scope user apple-notes -- uvx apple-mcp-notes

安全模式

• safe_readonly
• safe_manage
• full_access

传输方式

stdio 是默认且推荐的传输方式。设置 APPLE_NOTES_MCP_TRANSPORT=streamable-http（可选设置 APPLE_NOTES_MCP_HOST 和 APPLE_NOTES_MCP_PORT），即可改用 Streamable HTTP 提供服务。

读取和搜索笔记

列表和搜索结果会包含可用的笔记纯文本，因此搜索不仅能匹配标题和标签，也能匹配正文内容。笔记属性在 Notes.app 的 AppleScript 上下文中读取。如果笔记载荷中缺少文件夹元数据，则每次列表请求最多解析一次。

Notes 返回的字面控制字符和复杂表情符号会在 Python 端解码，不会更改其文本。锁定或不可用的笔记字段仍可能为空；仍需具备自动化访问权限。

脚本超时

每次 AppleScript 调用都受 APPLE_NOTES_MCP_SCRIPT_TIMEOUT_SECONDS 限制（默认值为 60，最小值为 5），因此即使 Notes.app 卡住，也不会让 MCP 请求无限期挂起。创建操作超时会返回 NOTE_CREATE_STATUS_UNKNOWN。标题和创建时间匹配，无法确定是哪次操作创建了笔记，因此服务不会修改匹配的笔记。重试前请检查目标文件夹。笔记时间戳使用绝对 UTC Unix 纪元时间。

macOS 权限

• 需要具备对 Notes 的自动化访问权限

启动检查清单

• 将 uvx apple-mcp-notes（或克隆仓库中的 AppleNotes-MCP/start.sh）添加到 MCP 客户端
• 重新加载或重新连接客户端，以便将 Notes 工具集加载到上下文中
• 首先调用 notes_health
• 如果 Notes 自动化受阻，请调用 notes_permission_guide
• 更改 macOS 权限后，请调用 notes_recheck_permissions

Notes 使用提示

• tools/list 会返回完整的 Notes 工具集。上下文受限的客户端可以先使用 search_tools，再针对所需的 Notes 工具调用 get_tool_info。
• 多个账户中可能各自都有 Notes 文件夹。首次使用时，请确认可用的账户和文件夹，并设置默认项。
• 使用 Notes 保存参考资料和上下文。
• 有时效性的事项应记入 Reminders 或 Calendar。

相关项目

• Apple-Tools-MCP