内容
# icloud-notes-connector
一款连接 Claude Desktop 到 macOS 上 iCloud Notes 的模型上下文协议（MCP）服务器。它允许 Claude 直接在 iCloud Notes 库中搜索、读取、列出、创建、更新、移动和删除笔记。
---
## 要求
- macOS
- [Claude Desktop](https://claude.ai/download)
- [Node.js](https://nodejs.org) v18 或更高版本
- 在您的 Mac 上启用 iCloud Notes
---
## 安装
1. 克隆此仓库：
```bash
git clone https://github.com/tdavis10002/icloud-notes-connector.git
cd icloud-notes-connector
```
2. 安装依赖项：
```bash
npm install
```
3. 将服务器添加到您的 Claude Desktop 配置文件中，位于：
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
在 `mcpServers` 下添加以下条目：
```json
{
"mcpServers": {
"icloud-notes-connector": {
"command": "node",
"args": ["/path/to/icloud-notes-connector/index.js"]
}
}
}
```
用您克隆仓库的实际路径替换 `/path/to/icloud-notes-connector`。
4. 重启 Claude Desktop。
---
## 权限
Claude 第一次使用连接器时，macOS 将显示一个自动化权限提示，询问是否允许应用程序控制 Notes。点击“确定”以批准。
如果提示未出现，请前往“系统设置”>“隐私和安全”>“自动化”，并为运行连接器的应用程序（通常是 Terminal 或 Node）启用 Notes 访问权限。
---
## 工具
| 工具 | 描述 |
|---|---|
| list_accounts | 列出在此 Mac 上配置的 Notes 帐户 |
| list_folders | 列出给定帐户中的文件夹 |
| list_notes | 列出帐户或文件夹中的笔记标题和 ID |
| search_notes | 在笔记标题和正文中进行不区分大小写的搜索 |
| read_note | 通过确切标题读取笔记的全文 |
| create_note | 创建带有标题和正文的新笔记 |
| update_note | 更新笔记的正文和可选标题 |
| move_note | 将笔记移动到不同文件夹 |
| delete_note | 通过确切标题删除笔记 |
---
## 注意事项
- 所有工具默认使用 iCloud 帐户。传递 `account` 参数以目标不同帐户。
- search_notes 返回的结果按 Notes 应用程序的默认排序顺序显示 - 最近修改的优先。
- search_notes 检查帐户中的每个笔记，对于非常大的库可能较慢。
- delete_note 无法撤销。
- 如果多个笔记共享相同标题，针对单个笔记的工具将作用于第一个匹配项。如有需要，请使用 list_notes 检索笔记 ID 以消除歧义。
---
## 许可证
MIT
