RK

ridafkih/keeper.sh

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

1429 stars 71 forks 质量 87 趋势 46AGPL-3.0

日历同步工具和通用日历MCP服务器。在Google、Outlook、Office 365、iCloud、CalDAV或ICS上汇总、同步和控制日历。

概览

Keeper 是一款简单且开源的日历同步工具。它允许你从远程托管的 iCal 或 ICS 链接中拉取事件,并将其推送到一个或多个日历上,使时间段能够在所有日历中保持一致。 - 从远程源汇总日历事件 - 事件内容无关的同步引擎 - 将聚合事件推送到一个或多个日历 - MCP(模型上下文协议)服务器支持 AI 代理日历访问 - AGPL-3.0 开源 - 易于自托管 - 易于清理远程事件 如果你遇到错误或有功能想法,可以在GitHub上发起问题,我们会尽快对其进行分类和修复。 高价值且高质量的贡献值得肯定。在处理你打算合并的大型特征之前,请先开启议题进行讨论。 开发环境运行在 HTTPS 后面,位于 https://keeper.localhost 处,使用带有自动 TLS 的 Caddy 反向代理。.localhost 顶级域名解析为 127.0.0。

概述(AI 翻译)

Keeper.sh 是一个简单且开源的日历同步工具。它允许你从谷歌日历、Outlook、iCloud、Fastmail、CalDAV 服务器,或远程托管的 iCal 和 ICS 链接中提取事件,并推送到一个或多个日历上,使时隙在所有日历间保持一致。Google、Outlook、iCloud、Fastmail 和 CalDAV 都是一流的集成,可以作为源或目的地使用,而 iCal 和 ICS 链接仅支持拉取。它还作为全球 MCP 服务器和 API,供你或你的代理通过一个便捷的界面管理所有日历。

推荐的运行方式是 keeper.sh 托管版本:代码相同,但没有服务器、域名、升级、备份,以及你本来会注册的谷歌和Microsoft登录应用。自托管是一条一流的途径,所有Pro功能都包含在你自托管时——这不是试用,也不会消失。它花费的是维护费用,而不是5美元。

特征

  • 一流的谷歌日历、Outlook、iCloud、Fastmail和CalDAV集成,均可作为源或目的地使用
  • 仅拉取远程托管的iCal和ICS链路

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

About

Keeper.sh is a simple & open-source calendar syncing tool. It allows you to pull events from your Google Calendar, Outlook, iCloud, Fastmail, CalDAV server, or remotely hosted iCal and ICS links, and push them to one or many calendars so the time slots can align across them all. Google, Outlook, iCloud, Fastmail, and CalDAV are first-class integrations that can each be used as a source or as a destination, while iCal and ICS links are pull-only. It also serves as a global MCP server and API for you or your agents to manage all your calendars from one convenient interface.

The recommended way to run it is the hosted version at keeper.sh: the same code, minus the server, the domain, the upgrades, the backups and the Google and Microsoft sign-in apps you would otherwise register yourself. Self-hosting is a first-class path and every Pro feature is included when you self-host — that is not a trial, and it is not going away. It costs you the upkeep instead of the $5.

Features

  • First-class Google Calendar, Outlook, iCloud, Fastmail, and CalDAV integrations, each usable as a source or a destination
  • Pull-only ingestion of remotely hosted iCal and ICS links
  • Incremental syncing on Google and Outlook using provider sync tokens rather than refetching everything
  • Event content agnostic syncing engine
  • Push aggregate events to one or more calendars
  • Per-source privacy controls to strip event names, descriptions, and locations, replacing the title with a {{calendar_name}} or {{event_name}} template
  • REST API under /api/v1 authenticated with API tokens
  • MCP (Model Context Protocol) server for AI agent calendar access
  • Combined iCal feed you can subscribe to from any calendar app
  • Open source under AGPL-3.0
  • Easy to self-host
  • Easy-to-purge remote events

Bug Reports & Feature Requests

If you encounter a bug or have an idea for a feature, you may open an issue on GitHub and it will be triaged and addressed as soon as possible.

Contributing

High-value and high-quality contributions are appreciated. Before working on large features you intend to see merged, please open an issue first to discuss beforehand.

Local Development

The dev environment runs behind HTTPS at https://keeper.localhost using a Caddy reverse proxy with automatic TLS. The .localhost TLD resolves to 127.0.0.1 automatically per RFC 6761 — no /etc/hosts entry is needed.

Prerequisites

Getting Started

bun install

Generate and Trust a Root CA

The dev environment runs behind HTTPS via Caddy. You need to generate a local root certificate authority and trust it so your browser accepts the certificate.

在 GitHub 查看完整 README

安装

docker run -d \
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "keeper": { "type": "url", "url": "https://keeper.example.com/mcp" } } }