Apple Reminders

Name: Apple Reminders
Author: mgcrea

本地服务

cupertino.mgcrea.io生产力5今天更新

代码仓库访问官网

关于 Apple Reminders

Apple Reminders 的 MCP 服务，通过 Apple Events 操作提醒事项，并可选用只读 SQLite 索引补充读取能力。写入工具默认不向模型注册，可通过配置启用。

主要功能

01浏览账户、列表和提醒事项
02搜索并读取提醒事项
03读取标签与附件需完全磁盘访问权限
04写入工具默认关闭

适用场景

01查找特定提醒事项
02查看提醒事项及其所属列表
03启用写入工具创建或完成提醒事项

MCP 相关

向 MCP 客户端提供 Apple Reminders 的读取和搜索工具；设置 APPLE_REMINDERS_ALLOW_WRITES=1 后才会注册创建、更新、完成、移动和删除工具。写入始终通过 Apple Events 执行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mgcrea-mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ],
      "env": {
        "APPLE_REMINDERS_ALLOW_WRITES": "<APPLE_REMINDERS_ALLOW_WRITES>",
        "APPLE_REMINDERS_LISTS": "<APPLE_REMINDERS_LISTS>",
        "APPLE_REMINDERS_ACCOUNTS": "<APPLE_REMINDERS_ACCOUNTS>"
      }
    }
  }
}

启动命令npx -y @mgcrea/mcp-apple-reminders

需要配置的环境变量

APPLE_REMINDERS_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.

APPLE_REMINDERS_LISTSRestrict every read and write to these Reminders lists, by name.

APPLE_REMINDERS_ACCOUNTSRestrict every read and write to these Reminders accounts, by name or id. Bounds reading, not just writing.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mgcrea/mcp-apple-reminders1.31.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@mgcrea/mcp-apple-reminders

适用于 macOS Apple Reminders 应用的 Model Context Protocol 服务。

非官方。 与 Apple 无关。本项目会驱动 Mac 上已有的 Reminders 应用。

两种模式

Apple Events 模式 — 账户、列表、提醒事项以及所有修改操作。Reminders 的脚本词典足够完整，单靠这一模式就能构成可用的服务。
索引模式 — 通过 Group Containers 存储目录，只读访问 SQLite，获取脚本词典未公开的信息。需要“完全磁盘访问权限”。

与 Notes 类似、与 Mail 不同，仅使用 Apple Events 模式即可正常使用。你可以安装并使用本项目，之后再决定是否授予“完全磁盘访问权限”。apple_reminders_diagnostics 会告知当前由哪种模式响应。

权限	用途	未授予时
自动化 → Reminders	所有功能	无法正常工作；会收到 `-1743` 错误
完全磁盘访问权限	标签、附件	服务仍会通过 Apple Events 模式运行

无需向 Reminders.app 授予这两项权限——需要权限的是 读取数据的一方。请将权限授予启动服务的应用（Terminal、iTerm、VS Code、Claude），然后重新启动它。

工具

读取：diagnostics、list_accounts、list_lists、list_reminders、search_reminders、get_reminder。

写入：仅当 APPLE_REMINDERS_ALLOW_WRITES=1 时才会注册；关闭此标志时，这些工具对模型不可见，而不只是被拒绝：create_reminder、update_reminder、complete_reminders、move_reminders、delete_reminders。

配置

变量	默认值
`APPLE_REMINDERS_ALLOW_WRITES`	关闭	注册可修改数据的工具。
`APPLE_REMINDERS_ACCOUNTS`	全部	读取端允许列表，以逗号分隔。
`APPLE_REMINDERS_LISTS`	全部	读取端允许列表，以逗号分隔。
`APPLE_REMINDERS_DEFAULT_LIST`	Reminders 的默认列表	未指定时，新提醒事项将添加到此列表。
`APPLE_REMINDERS_INCLUDE_COMPLETED`	关闭	读取时包含已完成的提醒事项。
`APPLE_REMINDERS_INDEX_MODE`	`auto`	`auto` \| `ro` \| `immutable` \| `off`。
`APPLE_REMINDERS_STORE`	自动	明确指定存储路径。
`APPLE_REMINDERS_DEGRADED_MAX_REMINDERS`	`500`	未使用索引时的数量上限。
`APPLE_REMINDERS_SEARCH_CACHE_TTL_MS`	`30000`	数据集保持预热的时长。
`APPLE_REMINDERS_ATTACHMENT_DIR`	`~/Downloads`	附件唯一可存放的目录。
`APPLE_REMINDERS_OSASCRIPT_TIMEOUT_MS`	`30000`	为首次运行时的权限提示预留的超时时长。

这些注意事项可能会让你措手不及

~/Library/Reminders 并不存在。 Reminders 位于 ~/Library/Group Containers/group.com.apple.reminders/ 下。其他地方常提到的路径在当前 macOS 上是错误的。
写入操作始终通过 Apple Events 进行，绝不直接操作存储目录。Reminders 应用会保持 SQLite 文件处于打开状态，并与服务器同步；直接写入会破坏同步状态。
默认不包含已完成的提醒事项。 如果搜索结果中“丢失”了某条提醒事项，通常是因为它已被标记为完成；请设置 APPLE_REMINDERS_INCLUDE_COMPLETED=1。