EK Bridge

EK Bridge

让 AI Agent 使用你的日历，但不是全部日历。
这是一款免费的开源 Mac 菜单栏应用，可让 Claude、ChatGPT、Cursor 和你的脚本仅使用你选择的日历和提醒事项列表，并在它们进行任何更改前征求你的同意。

下载 Mac 版 · 开始使用 · Agent 配置 · 更新日志

• 选择每个 Agent 可以操作的内容。 选择每个 Agent 可以使用的日历和提醒事项列表，以及它能否读取、创建、编辑、删除或完成事项。新 Agent 默认没有任何权限。
• 批准每一项更改。 面板会准确显示 Agent 想要写入的内容。除非你点击“允许”，否则不会进行任何更改。
• 查看所有操作，一键关闭。 活动记录会列出每个 Agent 做出的更改，并说明每次拒绝的原因。你可以暂停或移除某个 Agent，也可以从菜单栏暂停整个 EK Bridge。

支持 Claude Code、Claude Desktop、Codex 和 Cursor（已进行实时测试），以及任何其他 MCP 客户端；还为 VS Code（Copilot）、Gemini CLI、Zed、Cline、JetBrains AI Assistant 和 Devin Desktop 提供现成配置。claude.ai 和 ChatGPT 可通过远程访问进行连接，但此功能目前仍处于实验阶段。

你可以这样提问

连接 Agent 后，可以直接用日常语言提问。它只能操作你授予访问权限的日历和列表。

你提问	Agent 使用的工具
“这周我的工作日历上有什么安排？我有哪些空闲时段？”	read_events
“把周四的设计评审移到周五下午 3 点，时长不变。”	read_events，然后使用 update_event（会先征求你的同意）
“提醒我下周一早上 9 点续办护照。”	在你授予权限的列表中使用 create_reminder
“每个工作日安排上午 9:30–10:30 为专注时间。”	使用带重复规则的 create_event

12 个工具涵盖事件和提醒事项，并支持 Calendar 提供的所有字段：时区、重复规则、提醒、地点、备注和链接。每个 Agent 只能看到其访问权限允许使用的工具。MCP 指南提供了完整参考。

开始使用

1. 安装。 下载 EKBridge.dmg，打开后将 EK Bridge 拖到 Applications。如果你从磁盘映像或 Downloads 中打开它，系统会提示你将它移到那里。你也可以使用 Homebrew：

   brew install --cask bereciartua/tap/ek-bridge
   

2. 打开应用。 首次打开时会显示包含三个步骤的设置界面；之后，你可以在菜单栏中找到它。

   1. 允许访问 Calendar 和 Reminders。 只需允许 Agent 会使用的那个；另一个可以跳过。
   2. 添加 Agent。 选择它对应的磁贴（首先显示在 Mac 上找到的 Agent），并选择它开始时可以读取的内容，例如 读取所有日历和列表。只在 Agent 需要读取的内容上授予“读取”权限：读取的内容会发送给它使用的 AI 提供商。
   3. 连接。 添加到 Claude Desktop…（或 Cursor，或 Claude Code）会显示需要对 Agent 设置进行的确切更改、保留备份，并且绝不会写入令牌；同时还会开启 EK Bridge。对于其他 Agent，请从连接的 Connect 标签页复制命令或配置。收到 Agent 的第一个请求后，此步骤即完成。

就是这样：向你的 Agent 提出上面的问题即可。每种 Agent 的设置说明和故障排查方法都在 MCP 指南中。

EK Bridge 需要 macOS 14 或更高版本，可运行于 Apple 芯片或 Intel 处理器的 Mac 上。它已通过 Apple 公证，并会自动检查更新（每次更新都需要你点击安装）。版本说明和校验和见 Releases。要从其早期名称 EventKit Bridge 升级？请参阅设置。EK Bridge 是一个处于公开预览阶段的个人项目，提供尽力而为的支持。

如何由你掌控

EK Bridge 是唯一持有 Calendar 和 Reminders 访问权限的应用。你的 Agent 只会与它通信，绝不会直接访问你的日历；它会根据你授予的权限检查每个请求。

每个 Agent 只能访问你勾选的内容

每个 Agent 都有自己的密钥和访问权限：可针对每个日历设置读取、创建、编辑和删除权限，也可针对每个提醒事项列表设置完成权限。共享 Work，同时将 Family 留给自己。

每次更改都由你批准

默认情况下，Agent 写入任何内容之前，都会弹出一个小面板，显示它想设置的所有字段。点击 Allow 或 Deny，也可以让某个 Agent 工作 15 分钟。45 秒内未答复的请求会被拒绝。对于你信任的脚本，可以关闭询问。

### 它会在拒绝前征求你的同意

当 Agent 尝试在某个日历中添加、更改、完成或删除内容，而它可以读取该日历，却缺少执行这项操作的权限时，EK Bridge 会在同一面板中询问你：Claude Code 无法向 Groceries 添加提醒事项。你可以选择 Allow Once、Always Allow（仅保存这项操作的权限）或 Not Now。它绝不会询问 Agent 无法查看的日历；同一事项每小时最多询问一次。

所有操作一目了然，随时可以叫停

Activity 会按名称显示每个 Agent 更改的内容（已移动“Design review”），并用通俗易懂的语言解释每次拒绝。EK Bridge 只存储项目的 ID；打开条目时，它会查找项目名称，并提供 Show in Calendar。你可以 Pause 某个 Agent 的连接，在保留其设置的同时拒绝它的请求；也可以 Remove 它，彻底断开连接；还可以从菜单栏暂停整个 EK Bridge。你可以选择开启通知，以便在无人响应导致更改未执行时收到提醒。

底层安全机制

• 默认在本地运行。 在你开启之前，所有功能均处于关闭状态。MCP 服务仅监听 127.0.0.1。无需账号，不收集分析数据，也没有我们的服务器。
• 每个 Agent 都有自己的密钥。 每个 Agent 都有独立的 256 位令牌，且只以哈希形式存储；脚本使用各自的 Ed25519 密钥为请求签名。
• 安全写入。 编辑和删除操作需要项目的最新版本。每个写入字段都会被读回核对；如有不一致，则会回滚。
• 仅通过你自己的隧道连接云端。 云端 Agent 只能通过 Remote Access 和你运行的隧道访问 EK Bridge，且仅限你已允许的 Agent；Mac 处于睡眠、离线或退出登录状态时，绝不会建立连接。
• 更新经过签名。 更新来自 GitHub，由开发者签名，并在安装前进行验证。
• 开源。 查看代码、威胁模型和测试记录。

**它无法防护的情况：**以你的 macOS 用户身份运行的其他程序可以读取相同的密钥文件。访问设置用于区分你连接的 Agent，无法防御已存在于 Mac 上的恶意软件。详情请参阅安全边界。

常见问题

免费吗？

是的。EK Bridge 根据 Apache License 2.0 开源，无需账户或试用。

我的日历数据会离开我的 Mac 吗？

EK Bridge 本身不会向任何地方发送数据；隐私列出了它建立的每个连接。Agent 通过它读取的内容会发送给该 Agent 及其 AI 服务提供商，并受其条款约束，因此仅在 Agent 需要时授予读取权限。

每次更改前都会询问吗？

对于 AI Agent，默认会。你可以按连接关闭询问，例如用于你信任的脚本；也可以一次允许某个 Agent 的更改 15 分钟。请参阅更改前询问。

哪些日历可以使用？

日历和提醒事项应用中显示的账户都可以使用，例如 iCloud、Google、Exchange、CalDAV 和“在我的 Mac 上”。目前的实测使用的是 iCloud；请参阅测试。

可以与 ChatGPT 或 claude.ai 搭配使用吗？

可以，通过远程访问将云端 Agent 经由你运行的隧道转发到你的 Mac，例如 Tailscale Funnel。此功能默认关闭，且仍处于实验阶段；你的 Mac 必须保持唤醒并联网。请参阅使用云端 Agent。

我自己的脚本可以使用吗？

可以，使用命令行工具 bridge-client 即可。每个脚本都有自己的密钥和访问权限，就像 Agent 一样。请参阅使用脚本。

这与其他 Mac MCP 服务有什么不同？

大多数 MCP 服务都让 Agent 广泛访问许多应用，每个应用或服务只有一个开关。EK Bridge 只支持日历和提醒事项，但可以按日历、按 Agent 管理权限，并提供审批、活动日志和撤销功能。如果你信任某个 Agent 可以访问所有内容，可能就不需要它。

这是 Apple 开发的吗？

不是。EK Bridge 是一个独立的开源项目，基于 Apple 公开的 EventKit 框架构建。它与 Apple 没有关联，也未获 Apple 背书。

还有其他问题？请在讨论区提问。

更多连接方式

使用脚本

不使用 MCP 的脚本和工具可以使用 bridge-client，它会用该连接自己的密钥为每个请求签名。

1. 添加连接，选择 Connects from ▸ Command line，设置访问权限并点击 Save。

2. 从 Settings ▸ Advanced ▸ Install Command-Line Tool 安装该工具。它会将 bridge-client 链接到 ~/.local/bin；如果你的 shell 找不到它，请将该文件夹添加到 PATH。（Homebrew 已将它链接到自己的 bin 目录。）

3. 发送测试请求。连接页面上已准备好可供复制的命令：

   bridge-client scope_status --client "Morning briefing"
   

安装该工具之前，复制的命令会使用应用的完整路径 /Applications/EKBridge.app/Contents/MacOS/bridge-client，因此粘贴后即可运行。bridge-client --help 会列出所有命令及其所需的访问权限。错误信息会说明问题所在和修复方法，并为每种问题返回不同的退出代码。请参阅安全的首次 CLI 检查和 API 与 CLI 参考。

来自云端 Agent（实验性）

云端 Agent 在供应商的服务器上运行，无法访问 127.0.0.1。Remote Access（侧边栏中的独立页面，提供引导式设置；默认关闭）会开放第二个环回端口 47616，用于你运行的隧道，例如 Tailscale Funnel；应用会显示命令并测试结果。每个连接还需要启用 Allow cloud access。

• 发送标头的 Agent（Anthropic 和 OpenAI API、网页端 Claude Code、Cursor 和 Copilot 云端 Agent、Devin）使用连接专用的远程令牌。
• claude.ai、ChatGPT 和 Gemini Enterprise 通过 OAuth 登录，你需要在 Mac 上匹配六位数代码以批准授权。

Remote Access 支持离线测试，但尚未与每种云端 Agent 和隧道进行实时测试。仅在需要时开启，并对他人保密其 URL；其路径就是密钥。请参阅从云端 Agent 使用。

指南

目标	指南
安装、从源代码构建、签名和 macOS 访问	设置
添加连接并使用应用	用户指南
通过 MCP 连接 AI Agent，或通过 Remote Access 连接云端 Agent；工具参考	MCP 指南
调用 CLI 并了解命令参数	API 和 CLI 参考
了解进程、文件存储和安全限制	架构和威胁模型
查看测试内容并排查故障	测试和故障排除
参与贡献，或进行维护和发布	贡献指南、维护指南

隐私

此应用没有分析、遥测或崩溃报告功能，也不需要账号。你的日历、提醒事项、连接和活动记录都保留在 Mac 上。它建立的网络连接如下：

连接	时机
MCP 服务，在 127.0.0.1:47615 上侦听	仅当 EK Bridge 已开启且连接具有 MCP 访问权限时（在“设置”▸“高级”中关闭“本地 MCP 服务”即可停用）。仅限环回连接：其他电脑无法连接。
远程访问，在 127.0.0.1:47616 上侦听	仅当远程访问已开启时（默认关闭）。仅限环回连接；你运行的隧道会将云端 Agent 转发到此服务。
向你的远程访问地址发送一次 HTTPS 请求	仅当远程访问指南测试隧道时，或你点击远程访问页面上的测试时。
为云端 Agent 的客户端元数据发送一次 HTTPS 请求	仅当你配对 OAuth 云端 Agent（claude.ai、ChatGPT）时，向该 Agent 提供的地址发送。私有地址和本地地址会被拒绝。
bridge-mcp 连接到 127.0.0.1	Mac 上的 Agent 启动它以访问 MCP 服务时。
向 GitHub 发送一次 HTTPS 请求以获取 appcast.xml（最新版本列表）	当“设置”▸“通用”▸“自动检查更新”已开启时（下载的副本默认开启；从源代码构建的副本不会检查），每天一次；你选择“检查更新…”时也会发送。GitHub 会看到你的 IP 地址和应用版本，不会收到其他信息。
从 GitHub 下载更新	仅当你在更新窗口中点击安装更新后。安装前，应用会验证下载文件的 EdDSA 签名，并确认其由同一位开发者签署。

除了连接和活动记录，EK Bridge 还会在磁盘上保存你已授予访问权限的日历和列表的名称、账户及颜色（collection-labels.json），这样即使某项变得不可用，它仍能显示其名称。活动记录会为每次更改保存项目的 EventKit ID（而非标题），并在你打开该行时查找项目；EK Bridge 从不保存项目标题或内容。

通知由 macOS 显示。关于未执行的更改的通知可能包含项目标题，macOS 可能会根据你的设置在锁定屏幕上显示该标题；你可以在“设置”▸“通用”▸“通知”中逐项开启或关闭通知类型。

Agent 通过 EK Bridge 读取的内容会发送给该 Agent 及其 AI 提供商，并受其隐私条款约束，因此只授予每个 Agent 所需的权限。除 Tailscale Funnel 外，隧道服务可能会在其边缘节点读取远程访问流量。

安全边界

• 脚本密钥。 EK Bridge 会将每个命令行连接的 Ed25519 签名凭证存储在「应用程序支持」目录下、权限模式为 0600 的文件中；注册表只存储公钥验证器和授权。
• MCP 服务。 仅当 EK Bridge 处于开启状态且某个连接拥有 MCP 访问权限时运行。它只监听 127.0.0.1:47615，绝不监听网络接口。每个请求都需要该连接专属的 256 位令牌，令牌保存在权限模式为 0600 的文件中；注册表只存储其 SHA-256 哈希值，推荐的 Agent 设置会读取该文件，而不是将令牌放入 Agent 的配置中。系统会拒绝带有外部 Host、任何 Origin（网页）或隧道转发标头的请求，并会锁定反复登录失败的连接。请参阅威胁审查。
• 远程访问。 默认也处于关闭状态。开启后，它会在 127.0.0.1:47616 上监听由你运行的隧道；除 128 位秘密路径外，所有路径都会返回 404。只有启用了允许云端访问的连接才能使用远程访问，并且必须使用单独的远程令牌，或使用你在 Mac 上批准的 OAuth 连接。本地令牌不能通过远程访问使用，其凭证也不能用于本地端口。请参阅远程访问威胁审查。
• 请求文件归你所有，并且权限受到限制。

这些控制措施无法隔离以同一 macOS 用户身份运行的其他进程。 此类进程可以访问凭证、令牌或策略文件。因此，授权是此应用协议中各个连接之间的边界，并非抵御用户帐户遭入侵的防护措施。

请按照 SECURITY.md 中的说明，私下报告漏洞。

目前可用的功能

简要说明如上。以下是完整列表，以及 EventKit 不支持的功能：

显示完整列表

• 用户可为每个连接选择集合，并授予读取、创建、编辑、删除或完成提醒的权限。新连接默认没有任何权限。已保存的权限会一直保留，直到编辑权限或移除连接；EK Bridge 本身默认关闭，需在本地开启。连接可以暂停；暂停后会拒绝该连接的请求，但保留其凭据和访问权限，之后也可以恢复。
• Mac 上的 AI Agent 可使用 12 个 MCP 工具（list_collections、read_events、get_event、create_event、update_event、delete_event、read_reminders、get_reminder、create_reminder、update_reminder、complete_reminder、delete_reminder），时间格式为 ISO 8601。每个 Agent 只能看到其权限允许使用的工具。更改前询问可要求每个连接在每次写入前都征得你的批准，并显示所有将要更改的字段。
• 读取操作会返回数量有限的事件或提醒条目，不会不受限制地访问用户的 EventKit 存储。其他集合的读取会被拒绝。写入操作使用幂等键；编辑和删除操作要求使用最新的条目版本。
• 事件支持 EventKit 提供的所有字段：时间按你选择的时区保存（或使用 Mac 的时区，默认绝不使用 UTC）、最长一年的全天事件、备注、带地图图钉的位置、URL、提醒（包括到达或离开某个地点时触发的提醒）、忙闲状态和重复规则。重复事件可以逐次更改或删除、从某一次开始更改或删除，也可以整组更改或删除。与会者、组织者和你的回复均可读取；邀请保持只读，因为更改邀请可能会通知所有与会者。
• 提醒支持标题、截止日期和开始日期、备注、URL、优先级、多个提醒（包括位置提醒）、重复规则、完成和重新打开、在列表间移动，以及整组删除重复提醒。对于受监督探测已验证的提醒类型和账户类型，可以完成重复提醒中的单次提醒（目前已验证 iCloud 上带截止时间的每日提醒）。
• 更新只会更改请求中包含的字段，并且会回读每个已写入的字段：如果不匹配，就会移除新条目或还原已编辑的条目。无法通过 EventKit 邀请他人、回复邀请、处理附件和行程时间，也无法处理“提醒事项” app 的标签和子任务。
• 云端 Agent 可通过“远程访问”使用相同的工具：该功能需要运行由你启动的隧道，并为每个连接单独启用 允许云端访问 开关；每个连接可使用单独的远程令牌，也可以使用你在 Mac 上批准的 OAuth 连接。远程访问默认关闭，可设置定时自动关闭，也可以通过菜单栏一键关闭。
• 如果 Agent 缺少某个日历或列表上的一项操作权限，但已能读取该日历或列表，EK Bridge 会先询问你（允许一次、始终允许、暂不允许），而不是立即拒绝；此功能仅适用于写入操作、设有频率限制，并且可以按连接切换。
• 一个窗口包含概览、活动记录（显示更改内容、根据存储的 EventKit ID 实时查询条目名称；更改和问题保留 90 天；并注明每项请求来自 MCP、远程访问还是命令行）、各个连接和设置；菜单栏图标会显示 EK Bridge 已开启、已暂停或需要注意，启用远程访问时还会显示地球图标；支持可选通知和首次运行清单。
• 开启相应选项后，app 可在登录时启动。

支持矩阵和测试记录会区分已实现的行为、特定提供方的观察结果和未经测试的情况。

## 从源代码构建

你需要 macOS 14 或更高版本、Xcode 或 Xcode Command Line Tools，以及 Python 3。构建和离线测试不会安装应用，也不会请求访问权限：

sh test.sh
sh build.sh

构建会生成 build/EKBridge.app，其中包含 MCP 启动器 bridge-mcp 和命令行客户端 bridge-client（build/bridge-client 是指向它的链接）。默认情况下，应用使用 临时签名，macOS 会将其视为每次都是一个新应用；如需长期访问 Calendar 和 Reminders，请按照设置中的说明，使用稳定的身份签名。

• EVENTKIT_ARCHS="arm64 x86_64" sh build.sh 可构建通用应用。
• sh ui_test.sh 会运行窗口和行为测试，sh ui_snapshots.sh 会为每个屏幕写入截图；两者都使用虚假数据。
• 发布版本由 release.sh 构建（Developer ID 签名、公证、DMG 和 zip），可手动构建，也可通过发布工作流构建；请参阅维护。

如需贡献，请参阅贡献指南。

卸载

1. 从菜单栏菜单中退出应用。

2. 移除应用对 Calendar 和 Reminders 的访问权限。第一条命令会读取应用的 bundle ID，因此请在删除应用前运行这些命令：

   bundle_id=$(defaults read /Applications/EKBridge.app/Contents/Info CFBundleIdentifier)
   tccutil reset Calendar "$bundle_id"
   tccutil reset Reminders "$bundle_id"
   

3. 从 Applications 中删除应用，并删除其数据：~/Library/Application Support/EKBridge（连接、密钥、令牌、Activity 和写入日志）。如果你从 EventKit Bridge 升级而来，也请删除旁边的 EventKitBridge 链接。设置和更新器下载文件位于 ~/Library/Preferences/io.github.bereciartua.ekbridge.plist 和 ~/Library/Caches/io.github.bereciartua.ekbridge。

4. 如果安装了命令行工具，请删除 ~/.local/bin/bridge-client。

5. 从 Agent 的配置中移除该服务（例如 claude mcp remove ek-bridge），并停止你为远程访问运行的任何隧道。

通过 Homebrew 安装？请执行步骤 1、2 和 5，然后运行 brew uninstall --cask ek-bridge，即可移除应用及其 bridge-client 链接；添加 --zap 后，还会将步骤 3 中的数据和设置移至废纸篓。

项目状态

EK Bridge 处于公开预览阶段，提供尽力而为的支持。

• **离线测试：**本地桥接和 UI；MCP 服务、启动器、Agent 设置、远程访问及其 OAuth 服务，均通过真实的回环套接字和本地 HTTPS 测试夹具进行测试。
• **实时测试：**针对合成 EventKit 项目进行的有限测试、完整的 Mac 重启和登录测试（限定范围的读取仍可正常工作），以及首次使用 Claude Code、Claude Desktop、Codex 和 Cursor 进行的检查（连接、读取、获准的写入、拒绝的请求）。在搭载 Apple silicon 并启用 iCloud 的 macOS 27.0.1 上测试。
• **尚未运行：**完整的实时 Agent 测试矩阵和实时云端测试矩阵。尚未确认通知和提供商同步行为是否适用于所有重复事件形式。

请参阅测试和待检查事项以及更新日志。

许可证

EK Bridge 根据 Apache License 2.0 授权；请参阅 NOTICE。该许可证不授予使用项目名称或图标的权利。Apple、Mac 和 macOS 是 Apple Inc. 的商标。本项目与 Apple 无关，也未获得 Apple 背书。

EK Bridge 由 Martin Bereciartua 制作。