Apple Notes Model Context Protocol Server for Claude Desktop.

Apple Notes Model Context Protocol Server for Claude Desktop.

site icon
2024.12.11 80
Python笔记管理Claude集成内容生成
Apple Notes Model Context Protocol Server (apple-notes-mcp) 是一个用于Claude桌面的服务,能够读取本地Apple Notes数据库并将其提供给Claude桌面使用。通过该服务,Claude可以搜索用户遗忘的笔记,从而更深入地了解用户。该服务提供了读取和搜索笔记的功能,但目前不支持加密笔记、置顶笔记过滤、云同步状态处理、附件内容检索、清单状态处理以及创建或编辑笔记等功能。
View on GitHub

Overview

基本能力

产品定位

Apple Notes Model Context Protocol Server (apple-notes-mcp) 是一个用于Claude桌面的服务,能够读取本地Apple Notes数据库并将其提供给Claude桌面使用。

核心功能

  • 读取Apple Notes数据库
  • 提供笔记搜索功能
  • 支持获取所有笔记或特定笔记的完整内容

适用场景

  • 用户希望通过Claude搜索和查看本地Apple Notes中的内容
  • 需要快速访问遗忘的笔记

工具列表

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

常见问题解答

  • 不支持加密笔记(ZISPASSWORDPROTECTED)
  • 不支持置顶笔记过滤
  • 不支持云同步状态处理
  • 不支持附件内容检索
  • 不支持清单状态(ZHASCHECKLIST)
  • 不支持创建或编辑笔记

使用教程

使用依赖

  • 需要安装uv

安装教程

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

调试方式

使用MCP Inspector进行调试:

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

Mac OS磁盘权限

需要授予服务完全磁盘访问权限,因为Apple Notes的sqlite数据库位于MacOS文件系统的深层目录中。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。