Codex Reminders Bridge

让 Windows 上的 Codex 通过本地 MCP 工具管理当前用户自己的 iPhone/iCloud Reminders。

快速开始

1. 从 GitHub 仓库 下载源码或 Release ZIP。

2. 按 SETUP_GUIDE_ZH.md 准备 WSL、Codex 和 Apple App 专用密码。

3. 双击 install.cmd。

4. 重启 Codex，然后说：“列出我未完成的 iPhone 提醒事项。”

Related MCP server: MCP Apple Reminders

能做什么

• 同步并列出未完成或全部提醒；

• 创建带截止日期、备注和优先级的提醒；

• 修改、完成和删除提醒；

• 标题重名时使用 UID 消除歧义；

• 写操作前后同步，修改和删除前保留本地备份；

• 通过 MCP 工具描述和 AGENTS.md 约束 Codex 的操作流程。

隐私边界

仓库和发布 ZIP 不包含 Apple ID、密码、CalDAV URL、集合 UUID、提醒内容、同步缓存或个人数据库。首次安装后，凭据保存在当前 WSL 用户的：

~/.local/share/codex-reminders-bridge/

密码文件权限设置为仅当前用户可读。应用永远不要求 Apple Account 主密码，只使用可单独撤销的 App 专用密码。

组件

Codex
  -> iphone-reminders MCP (stdio)
  -> Reminders Bridge
  -> vdirsyncer + iCloud CalDAV
  -> iPhone Reminders

核心代码位于 app/；安装器把它复制到 WSL 私有目录并创建隔离虚拟环境。运行数据不写回仓库。

发布检查

创建新版本前请：

1. 运行测试和隐私扫描；

2. 更新 VERSION；

3. 将干净的发布 ZIP 附加到 GitHub Release。

本项目通过 iCloud 的 CalDAV 兼容层访问 VTODO。Apple 没有为此项目背书；接口行为变化可能需要更新适配。