使用说明
Apple Notes MCP服务器
用于macOS上Apple Notes集成的MCP(模型上下文协议)服务器。提供创建、读取和搜索Apple Notes的程序化访问。
特性
- 搜索笔记:使用逗号分隔的搜索词查找注释(OR逻辑)
- 按标题获取注释:按标题检索笔记内容
- 按ID获取笔记:通过其唯一ID检索笔记内容
- 创建便笺:创建带有标题和内容的新笔记
需求
- macOS(Apple Notes仅适用于macOS)
- Node.js(建议使用14或更高版本)
- 已安装Apple Notes应用程序
安装
npm install
用法
这是一个设计用于MCP兼容客户端的MCP服务器。要运行服务器,请执行以下操作:
npm start
或者直接:
node index.js
可用工具
find_apple_notes
使用逗号分隔的术语搜索笔记(或搜索)。
参数:
search_terms(字符串,必填):逗号分隔的搜索词
退货: 具有id、title、creation_date和modification_date的匹配注释的JSON数组
获取应用注释标题
通过标题获取特定笔记的内容。
参数:
title(string,必填):注释的标题
退货: 以文本形式记录内容
获取应用注释id
通过特定笔记的ID获取其内容。
参数:
note_id(string,必填):钞票的ID
退货: 以文本形式记录内容
create_apple_note
在Apple Notes中创建新笔记。
参数:
title(string,必填):新注释的标题content(string,必填):新注释的内容
退货: 带有新钞ID的成功消息
配置
要将此MCP服务器与Claude Desktop或其他MCP客户端一起使用,请将其添加到MCP配置文件中:
{
"mcpServers": {
"apple-notes": {
"command": "node",
"args": ["/path/to/apple-notes-mcp/index.js"]
}
}
}
局限性
- 仅适用于安装了Apple Notes的macOS
- osascript需要适当的权限才能访问Notes
- 只读操作-无编辑或删除功能(保留注释完整性)
许可证
麻省理工学院
