Apple Notes 模型上下文协议服务器（用于 Claude 桌面版）
读取您本地的 Apple Notes 数据库，并将其提供给 Claude 桌面版。
现在 Claude 可以搜索您最常忘记的笔记，并更了解您。
不出意外。
组件
资源
服务器实现了对 Apple Notes 的读写能力。
工具
服务器提供多种提示：
get-all-notes：获取所有笔记。read-note：获取特定笔记的完整内容。search-notes：在笔记中搜索。
缺失功能：
- 不处理加密笔记（ZISPASSWORDPROTECTED）
- 不支持置顶笔记筛选
- 不处理云端同步状态
- 缺失附件内容检索
- 不支持清单状态（ZHASCHECKLIST）
- 无法创建或编辑笔记
快速入门
安装服务器
建议使用 uv 在本地为 Claude 安装服务器。
uvx apple-notes-mcp
OR
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 解决方案。
开发
构建和发布
为分发准备包：
- 同步依赖并更新锁文件：
uv sync
- 构建包分发：
uv build
这将创建 dist/ 目录中的源代码和轮包。
- 发布到 PyPI：
uv publish
注意：您需要通过环境变量或命令标志设置 PyPI 凭据：
- 令牌：
--token或UV_PUBLISH_TOKEN - 或用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于 MCP 服务器通过 stdio 运行，调试可能具有挑战性。为获得最佳调试体验，我们强烈建议使用 MCP 检查器。
您可以通过 npm 使用以下命令启动 MCP 检查器：
npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp
启动后，检查器将显示一个 URL，您可以在浏览器中访问以开始调试。
许可证
本项目根据 MIT 许可证授权。详情请参阅 LICENSE 文件。
源代码
源代码可在 GitHub 上获取。
贡献
请通过 Bluesky 联系我或通过打开问题提出您的想法和反馈。