苹果笔记交互服务器

一个用于在macOS上与Apple Notes进行交互的MCP服务器,支持列出、搜索、创建、更新和删除笔记等功能。

  • by arslankhanali
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 arslankhanali/apple-notes-mcp

使用说明

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帐户