适用于Claude桌面的Apple Notes模型上下文协议服务器

读取您本地的Apple Notes数据库，并将其提供给Claude桌面版。

现在，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桌面版

在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

2. 构建包分发：

uv build

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

3. 发布到PyPI：

uv publish

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

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

调试

由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。

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

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

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

许可证

本项目采用MIT许可证。详情请参阅 LICENSE 文件。

源代码

源代码可在 GitHub 上获取。

贡献

将您的想法和反馈发送到 Bluesky 或通过提交问题。