使用说明
Apple Notes MCP服务器
用于在macOS上与Apple Notes交互的MCP(模型上下文协议)服务器。
特性
- 列出所有帐户或特定帐户/文件夹的注释
- 按内容搜索笔记
- 阅读笔记内容
- 创建新笔记
- 更新现有笔记
- 删除笔记
- 列出可用帐户
需求
- macOS(使用AppleScript与Notes应用程序交互)
- Python 3.10+
- 必须安装Notes应用程序并可访问
备注
- 服务器使用AppleScript与Notes应用程序交互
- 您需要授予终端/iTerm/Cursor 许可 在“系统首选项”>“安全与隐私”>“辅助功能”中控制“备注”
- 帐户名区分大小写(例如,“iCloud”与“iCloud”)
安装
git clone https://github.com/arslankhanali/apple-notes-mcp.git
cd apple-notes-mcp
uv venv
source .venv/bin/activate
uv add "mcp[cli]"
# To run
# uv run apple_notes.py
使用游标
添加到MCP配置(~/.cursor/mcp.json):
改变
/path/to/apple-notes-mcp将此仓库克隆到何处
{
"mcpServers": {
"apple-notes": {
"command": "uv",
"args": [
"--directory",
"/path/to/apple-notes-mcp",
"run",
"apple_notes.py"
]
}
}
}
可用工具
list_notes-列出特定帐户/文件夹中的所有笔记或笔记search_notes-搜索包含特定文本的笔记read_note-阅读特定笔记的内容create_note-创建一个带有标题和内容的新笔记update_note-更新现有注释的内容delete_note-删除注释list_accounts-列出所有可用的Notes帐户