ridafkih/keeper.sh

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

1429 stars 71 forks 品質 87 トレンド 46AGPL-3.0

Repository Install

カレンダー同期ツールおよびユニバーサルカレンダーMCPサーバー。Google、Outlook、Office 365、iCloud、CalDAV、ICS上でカレンダーを集約、同期、管理できます。

概要

Keeperはシンプルでオープンソースのカレンダー同期ツールです。リモートでホストされているiCalやICSリンクからイベントを引き出し、1つまたは複数のカレンダーにプッシュして、すべてのカレンダーでタイムスロットを整合させることができます。 - リモートソースからのカレンダーイベントの集約 - イベント内容に依存しない同期エンジン - イベントを1つ以上のカレンダーにプッシュ - AIエージェントカレンダーアクセスのためのMCP(モデルコンテキストプロトコル)サーバー - AGPL-3.0によるオープンソース - セルフホストが容易 - リモートイベントの簡単なパージバグに遭遇したり、機能のアイデアがあればGitHubで問題を提出すれば、できるだけ早く対応・処理される予定です。価値が高く質の高い貢献を歓迎します。統合予定の大規模な機能に取り組む前に、事前に問題を開いて話し合ってください。開発環境はhttps://keeper.localhostのHTTPSの背後でCaddyリバースプロキシと自動TLSを使って動作します。.localhostのTLDは127.0.0に解決されます。

概要（AI 翻訳）

Keeper.sh はシンプルでオープンソースのカレンダー同期ツールです。Googleカレンダー、Outlook、iCloud、Fastmail、CalDAVサーバー、またはリモートホストのiCalやICSリンクからイベントを引き出し、1つまたは複数のカレンダーにプッシュして、すべてのカレンダーでタイムスロットを整合させることができます。Google、Outlook、iCloud、Fastmail、CalDAVは、それぞれソースや宛先として使える一流の統合ツールですが、iCalやICSのリンクはプル専用です。また、グローバルMCPサーバーおよびAPIとして機能し、あなたやエージェントが1つの便利なインターフェースからすべてのカレンダーを管理できます。

推奨される運用方法は、keeper.sh のホスト版で、サーバー、ドメイン、アップグレード、バックアップ、そして自分で登録するGoogleやMicrosoftのサインインアプリを除いた同じコードです。セルフホスティングは一流の道であり、セルフホスティングにはすべてのPro機能が含まれます。これはトライアルではなく、廃止されることはありません。5ドルの維持費ではなく、維持費がかかります。

特徴

一流のGoogleカレンダー、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

Bun (v1.3.11+)
Docker & Docker Compose

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 \

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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