📝 Apple Notes MCP Server

📝 Apple Notes MCP Server

site icon
2025.03.12 3
TypeScript笔记管理自然语言交互交流协作
Apple Notes MCP Server 是一个基于 Model Context Protocol 的服务,旨在通过自然语言与 Apple Notes 进行无缝交互。用户可以通过 Claude 或其他 AI 助手轻松创建、搜索和检索笔记。该服务支持 iCloud 集成,直接与用户的 iCloud Notes 账户同步。
View on GitHub

Overview

📝 Apple Notes MCP Server

产品定位

Apple Notes MCP Server 是一个用于与 Apple Notes 进行交互的 MCP 服务器,通过自然语言实现笔记的创建、搜索和检索。

核心功能

  • 创建笔记:快速创建带有标题、内容和标签的笔记。
  • 搜索笔记:通过强大的搜索功能查找笔记。
  • 检索内容:根据标题获取笔记的完整内容。
  • iCloud 集成:直接与 iCloud Notes 账户同步。

适用场景

  • 快速笔记:在会议或头脑风暴中快速记录笔记。
  • 信息检索:通过搜索功能快速找到特定笔记。
  • 内容回顾:获取并查看特定笔记的完整内容。

工具列表

  1. Create Note:创建新笔记,支持标题、内容和可选标签。
  2. Search Notes:通过查询字符串搜索笔记。
  3. Get Note Content:根据标题获取笔记的完整内容。

常见问题解答

  • 确保 Apple Notes 应用已正确配置 iCloud。
  • 使用描述性标题以提高搜索效率。
  • 创建笔记时包含相关标签以便更好地组织。

🚀 使用教程

使用依赖

  1. 已配置 Apple Notes 应用的 macOS 系统。
  2. Node.js(版本 20.0.0 或更高)。
  3. Yarn 包管理器。

安装教程

  1. 克隆仓库: bash git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git cd mcp-apple-notes
  2. 安装依赖: bash yarn install
  3. 构建项目: bash yarn build
  4. 启动服务器: bash yarn start
  5. 配置 Claude Desktop,更新 claude_desktop_config.json 文件。

调试方式

启动服务器后,确认看到以下信息:

Starting Apple Notes MCP server.

服务器即已准备好处理笔记操作。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。