Apple Notes Model Context Protocol Server 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

2. 构建包分布：

uv build

这将在dist/目录下创建源代码和wheel分布。

3. 发布到PyPI：

uv publish

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

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_P_UBLISH_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账户，或通过打开问题的方式贡献。