AI导哈

Apple Notes集成服务

一个MCP服务器，允许Claude读取、创建和编辑Apple Notes。

  • by nickholub
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nickholub/macos-notes-mcp

使用说明

注释文本mcp

Claude Apple Notes集成。一个MCP服务器，让Claude读取、创建和编辑您的Apple Notes。

需求

  • macOS与Notes.app
  • Python 3.10+
  • mcp>=1.2.0 包裹
  • osascript的自动化权限

设置

  1. 克隆并安装：

    git clone https://github.com/nickholub/notes-text-mcp.git
cd notes-text-mcp
pip install -e .

  2. 配置您的Claude客户端：

    选项A： 从项目目录中，询问Claude Code：

    将此项目中的注释文本MCP服务器添加到Claude Code和Claude Desktop配置中

    选项B： 手动配置：

    克劳德代码 -添加到 ~/.claude/.mcp.json:

    {
  "mcpServers": {
    "notes-text": {
      "command": "python3",
      "args": ["/path/to/notes-text-mcp/mcp_server/server.py"]
    }
  }
}

    克劳德桌面 -添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

    {
  "mcpServers": {
    "notes-text": {
      "command": "python3",
      "args": ["/path/to/notes-text-mcp/mcp_server/server.py"]
    }
  }
}

用法

配置后，询问Claude：

  • “列出我的苹果笔记”
  • “创建一个名为“会议笔记”的新笔记”
  • “分析我的想法笔记中的想法，并为其添加利弊”
  • “为我的项目待办事项列表中的项目分配优先级”
  • “我的项目待办事项记录中的语法正确”
  • “告诉我周一和周二我在日记中做了哪些练习”
  • “将鸡蛋添加到我的购物清单备注中”

工具

支持阅读、创建和更新笔记。故意省略删除以防止意外数据丢失。

工具 目的
list_notes 在文件夹中列出笔记
read_note 阅读笔记HTML内容
create_note 使用HTML内容创建新笔记
update_note 用HTML更新笔记

测试

pip install -e ".[dev]"
pytest

局限性

  • 更新笔记可能会改变其格式（特别是带有清单的笔记）
  • 复选框状态与HTML分开存储，在更新时无法保留

建筑

┌─────────────┐     MCP/stdio     ┌─────────────┐    subprocess    ┌───────────┐
│   Claude    │ ◄──────────────► │  server.py  │ ◄──────────────► │ osascript │
│   (Client)  │                   │  (FastMCP)  │                  │           │
└─────────────┘                   └─────────────┘                  └─────┬─────┘
                                                                        │
                                                                        │ AppleScript
                                                                        ▼
                                                                  ┌───────────┐
                                                                  │   Apple   │
                                                                  │   Notes   │
                                                                  └───────────┘

相关 MCP