Apple Notes 模型上下文协议服务器 for Claude Desktop

读取您的本地 Apple Notes 数据库并提供给 Claude Desktop。

现在 Claude 可以搜索您最遗忘的笔记，并更了解您。

没有什么会出错。

组件

资源

该服务器实现了读写您的 Apple Notes 的功能。

工具

该服务器提供了多个提示：

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

缺失的功能：

• 未处理加密笔记 (ZISPASSWORDPROTECTED)
• 不支持固定笔记过滤
• 未处理云同步状态
• 缺少附件内容检索
• 不支持清单状态 (ZHASCHECKLIST)
• 无法创建或编辑笔记

快速开始

安装服务器

推荐使用 uv 在本地为 Claude 安装服务器。

uvx apple-notes-mcp

或者

uv pip install apple-notes-mcp

按照以下说明添加您的配置。

Claude Desktop

在 MacOS 上: ~/Library/Application\ Support/Claude/claude_desktop_config.json
在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

注意：您可能需要使用 uv 的直接路径。使用 which uv 查找路径。

开发/未发布的服务器配置

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

已发布的服务器配置

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

Mac OS 磁盘权限

您需要授予服务器完全磁盘访问权限。这是因为 Apple Notes sqlite 数据库嵌套在 MacOS 文件系统的深处。

如果这让我感到困扰，或者我想开始向 Apple Notes 添加/追加内容，我可能会在未来考虑使用 AppleScript 解决方案。

开发

构建和发布

准备包以进行分发：

1. 同步依赖项并更新锁文件：

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录中创建源码和 wheel 分发。

1. 发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭证：

• 令牌: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器运行在标准输入输出上，调试可能会很困难。为了获得最佳调试体验，我们强烈建议使用 MCP Inspector。

您可以使用 npm 通过以下命令启动 MCP Inspector：

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

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

许可

该项目根据 MIT 许可证授权。有关详细信息，请参阅 LICENSE 文件。

源代码

源代码可在 GitHub 上获取。

贡献

请将您的想法和反馈发送给我，您可以通过 Bluesky 或者通过打开一个问题来联系我。