注释文本mcp
Claude Apple Notes集成。一个MCP服务器，让Claude读取、创建和编辑您的Apple Notes。
需求
- macOS与Notes.app
- Python 3.10+
mcp>=1.2.0包裹- osascript的自动化权限
设置
- 克隆并安装：
git clone https://github.com/nickholub/notes-text-mcp.git
cd notes-text-mcp
pip install -e .- 配置您的Claude客户端：
选项A： 从项目目录中，询问Claude Code：
> 将此项目中的注释文本MCP服务器添加到Claude Code和Claude Desktop配置中
选项B： 手动配置：
克劳德代码 -添加到 ~/.claude/.mcp.json:
{
"mcpServers": {
"notes-text": {
"command": "python3",
"args": ["/path/to/notes-text-mcp/mcp_server/server.py"]
}
}
}克劳德桌面 -添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"notes-text": {
"command": "python3",
"args": ["/path/to/notes-text-mcp/mcp_server/server.py"]
}
}
}用法
配置后，询问Claude：
- “列出我的苹果笔记”
- “创建一个名为“会议笔记”的新笔记”
- “分析我的想法笔记中的想法，并为其添加利弊”
- “为我的项目待办事项列表中的项目分配优先级”
- “我的项目待办事项记录中的语法正确”
- “告诉我周一和周二我在日记中做了哪些练习”
- “将鸡蛋添加到我的购物清单备注中”
工具
支持阅读、创建和更新笔记。故意省略删除以防止意外数据丢失。
| 工具 | 目的 |
|---|---|
list_notes | 在文件夹中列出笔记 |
read_note | 阅读笔记HTML内容 |
create_note | 使用HTML内容创建新笔记 |
update_note | 用HTML更新笔记 |
测试
pip install -e ".[dev]"
pytest局限性
- 更新笔记可能会改变其格式（特别是带有清单的笔记）
- 复选框状态与HTML分开存储，在更新时无法保留
建筑
┌─────────────┐ MCP/stdio ┌─────────────┐ subprocess ┌───────────┐
│ Claude │ ◄──────────────► │ server.py │ ◄──────────────► │ osascript │
│ (Client) │ │ (FastMCP) │ │ │
└─────────────┘ └─────────────┘ └─────┬─────┘
│
│ AppleScript
▼
┌───────────┐
│ Apple │
│ Notes │
└───────────┘