Notes MCP：通过 Claude、Cursor等访问和操作 macOS 上的 Apple Notes

Notes MCP是一款运行在macOS系统上的MCP服务器程序，主要功能是实现Apple Notes与大语言模型（LLMs）的连接。通过Notes MCP，你能够在支持MCP协议的应用（如Claude、Cursor等）中直接调用Apple Notes中的笔记内容，完成笔记检索、内容读取、新建笔记等操作。

支持的操作指令

• notes-get-folders：获取Apple Notes中的所有文件夹列表。

• notes-get-notes：获取指定文件夹内的全部笔记。

• notes-create-note：创建新笔记，需指定标题和内容。

• notes-get-note-by-id：通过笔记唯一标识符获取单条笔记内容。

• notes-get-note-by-title：通过精确标题匹配查找单条笔记。

• notes-get-note-count：获取账户内的笔记总数。

以Claude为例，调用notes-get-notes指令可列出“GetURLData”文件夹下的所有笔记：

1、[GetURLData] Launch
2、[GetURLData] API
3、[GetURLData] Architecture

进一步使用notes-get-note-by-title指令，可读取指定笔记内容，例如获取“[GetURLData] Launch”的内容：

[GetURLData] Launch
发布计划：
...

Notes MCP安装使用

1、构建项目

首先需安装依赖并编译代码，在终端执行以下命令：

npm install && npm run build

2、在Claude中配置

• 编辑配置文件：打开~/Library/Application Support/Claude/claude_desktop_config.json，添加MCP服务器配置：

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["文件路径/notes-mcp/dist/index.js"]
    }
  }
}

• 验证运行：进入Claude设置页面，查看“Developer notes”状态，显示“notes running”，路径正确。

3、在Cursor中配置 • 修改配置文件：找到Cursor的MCP服务器配置文件（通常需自行创建或在设置中配置），加入相同的JSON结构：

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["文件路径/notes-mcp/dist/index.js"]
    }
  }
}

• 启用服务：在Cursor的“Settings”→“MCP Servers”中添加全局服务器，确认指令列表显示所有支持的工具（如notes-create-note、notes-get-folders等）。

独立运行

若需独立使用或集成到其他项目中，可直接通过终端启动服务：

node dist/index.js

Notes MCP基于MCP协议开发，理论上兼容所有支持该协议的大语言模型应用，用户可根据自身需求扩展使用场景。