ridafkih/keeper.sh

这是什么？

核心功能

• 01在 Google 日历、Outlook、iCloud、Fastmail 和 CalDAV 之间双向选择源与目标
• 02从 iCal 和 ICS 链接拉取事件
• 03Google 与 Outlook 通过服务商同步令牌进行增量同步
• 04按源设置隐私选项，隐藏事件标题、描述和地点
• 05提供 REST API 与 MCP 服务，便于程序或 AI 智能体管理日历
• 06提供合并的 iCal 订阅地址，任意日历应用均可订阅

适用场景

• 让工作、个人和商务日历保持同步，避免会议时间冲突
• 在不暴露事件详情的前提下，把忙碌时段同步到其他日历
• 让 AI 智能体通过 MCP 读取和管理日历
• 在自有 PostgreSQL 和 Redis 上自托管日历聚合服务

快速上手

1. 1

   安装依赖（需要 Bun v1.3.11+ 和 Docker）

   bun install
2. 2

   启动开发环境（PostgreSQL、Redis、Caddy 及所有服务）

   bun dev
3. 3

   在浏览器中打开 https://keeper.localhost（请先按 README 信任本地根证书）

使用前须知

• !自托管意味着你需要自己运行服务器、域名、升级和备份。
• !自托管需要自行注册 Google 和 Microsoft 的 OAuth 应用。
• !AGPL-3.0 是 Copyleft 许可证，若你将修改后的版本作为服务运行，必须以相同条款公开源代码。

收录于专题

标签

常见问题

keeper.sh 是什么？

开源日历同步工具，可在 Google、Outlook、iCloud、Fastmail、CalDAV 和 ICS 日历之间聚合与同步事件，并提供 MCP 服务。 Keeper.sh 可从 Google 日历、Outlook、iCloud、Fastmail、CalDAV 服务器以及远程 iCal/ICS 链接拉取事件，再推送到一个或多个目标日历，让忙碌时段在各处保持一致。Google、Outlook、iCloud、Fastmail 和 CalDAV 既可作为源也可作为目标，iCal 与 ICS 链接只能作为源拉取。

keeper.sh 可以免费使用吗？用的什么许可证？

keeper.sh 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

keeper.sh 还在维护吗？

活跃维护中。keeper.sh 最近一次提交是在 2026年11月7日。

keeper.sh 适合用来做什么？

让工作、个人和商务日历保持同步，避免会议时间冲突 在不暴露事件详情的前提下，把忙碌时段同步到其他日历 让 AI 智能体通过 MCP 读取和管理日历 在自有 PostgreSQL 和 Redis 上自托管日历聚合服务

keeper.sh 怎么安装和运行？

安装依赖（需要 Bun v1.3.11+ 和 Docker）: bun install 启动开发环境（PostgreSQL、Redis、Caddy 及所有服务）: bun dev 在浏览器中打开 https://keeper.localhost（请先按 README 信任本地根证书）

在哪里获取 keeper.sh？

源代码和安装说明在 GitHub 上：https://github.com/ridafkih/keeper.sh