Apple Notes MCP Server

使用模型上下文协议（MCP）自动化Apple Notes的强大工具

mcp-name: io.github.henilcalagiya/mcp-apple-notes

概述

Apple Notes MCP Server 提供了与任何兼容MCP客户端无缝集成Apple Notes的功能。它通过简单且安全的AppleScript API层实现了完整的笔记自动化——包括创建、读取、更新和删除笔记。

功能

• 对Apple Notes的完整CRUD支持（创建、读取、更新、删除）
• 与Continue.dev、Claude Desktop、Perplexity和其他MCP客户端兼容
• 原生AppleScript集成，实现可靠的macOS自动化
• 全面的工具用于Apple Notes自动化
• 自动安装通过uvx或手动设置
• 现代装饰器API的FastMCP实现

要求

• macOS - 需要AppleScript支持
• Python 3.10+ - 需要MCP SDK兼容性
• Apple Notes应用 - 必须已安装并可访问
• 兼容MCP的客户端（例如，Continue.dev、Claude Desktop）

快速开始

第一步：安装uv（如果尚未安装）

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

替代方案（pip）:

pip install uv

第二步：添加MCP配置

在您的MCP客户端中添加此配置：

对于Perplexity、Cursor、Continue.dev、Claude Desktop:

{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["mcp-apple-notes@latest"]
    }
  }
}

🎉 就这样！ 当需要时，您的MCP客户端会自动安装并运行该包。

注意： 确保您的MCP客户端有权访问Apple Notes并在系统偏好设置→安全性与隐私→隐私→辅助功能中执行AppleScript命令。

可用工具

笔记管理（6个工具）

• create_note - 使用HTML内容创建笔记
• read_note - 根据ID验证后读取笔记
• update_note - 使用HTML内容根据ID更新笔记
• delete_note - 根据ID验证后删除笔记
• move_note - 在文件夹之间移动笔记
• list_all_notes - 列出所有文件夹中的所有笔记

文件夹管理（5个工具）

• create_folder - 创建具有路径支持的文件夹
• read_folder - 根据ID读取文件夹详情
• rename_folder - 根据ID重命名文件夹
• delete_folder - 根据ID删除文件夹
• move_folder - 在位置之间移动文件夹

搜索与结构（3个工具）

• search_notes - 根据关键词搜索笔记
• list_folder_with_structure - 显示文件夹层次结构
• list_notes_with_structure - 显示文件夹+笔记层次结构

内容支持

HTML格式化: <h1-h6>，<b><i><u>，<p><div><br>，<ul><ol><li>，<table>，<a>

特殊功能：

• 支持Unicode和表情符号（🚀，✅，📝）
• 嵌套文件夹路径（最多5级）
• 自动字符转义
• 包含标题、列表、表格的丰富内容

架构

服务器遵循MCP协议规范，并采用模块化架构构建：

• AppleScript层 - 处理与Apple Notes的直接交互
• 工具层 - 将AppleScript操作封装为MCP工具
• FastMCP服务器层 - 使用装饰器实现MCP协议

故障排除

常见问题

1. “没有名为'mcp'的模块”错误

   • 使用uvx进行自动安装
   • 确保uv已安装并在PATH中

2. AppleScript权限被拒绝

   • 在系统偏好设置→安全性与隐私→隐私→辅助功能中授予终端/MCP客户端权限

3. 未找到笔记

   • 确保已安装并可访问Apple Notes应用
   • 检查默认位置是否存在笔记

许可证

该项目使用MIT许可证 - 查看LICENSE文件以获取详细信息。

作者

Henil C Alagiya

• GitHub: @henilcalagiya
• LinkedIn: Henil C Alagiya

支持与贡献：

• 🐛 报告问题: GitHub Issues
• 💬 提问: 在LinkedIn上联系
• 🤝 贡献: 欢迎提交拉取请求！