Apple Notes MCP 快速开始指南

使用 Claude 模型上下文协议读取您的 Apple Notes 笔记。

安装

使用 uv 安装服务器:

uvx apple-notes-mcp

或者:

uv pip install apple-notes-mcp

配置 Claude 桌面版

在以下位置编辑配置文件:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

添加服务器配置:

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

授予权限

重要: 您需要在 MacOS 的系统偏好设置中授予完全磁盘访问权限，因为服务器需要访问 Apple Notes 数据库。

功能

服务器提供三个主要功能:

• get-all-notes: 获取所有笔记
• read-note: 获取特定笔记的完整内容
• search-notes: 在笔记中搜索内容

限制

• 不支持加密笔记
• 不支持创建或编辑笔记
• 不处理附件内容

调试

使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

更多信息

源码: GitHub
许可: MIT

反馈请通过 Bluesky 或 GitHub Issues 提交。