ridafkih/keeper.sh

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

1,4 тыс. stars 71 forks Качество 87 Тренд 46AGPL-3.0

Инструмент синхронизации календарей и универсальный MCP-сервер календаря. Агрегировать, синхронизировать и управлять календарями в Google, Outlook, Office 365, iCloud, CalDAV или ICS.

Обзор

Keeper — это простой и открытый инструмент синхронизации календарей. Он позволяет получать события с удалённо размещённых iCal или ICS-каналов и передавать их в один или несколько календарей, чтобы временные слоты совпадали между ними. - Агрегация событий календаря из удалённых источников - Движок синхронизации, независимый от содержания событий - Push агрегированных событий в один или несколько календарей - Сервер MCP (Model Context Protocol) для доступа к календарю агентов ИИ - Открытый исходный код под AGPL-3.0 - Простота самохостинга - Легко очищаемые удалённые события Если вы столкнётесь с багом или у вас есть идея для функции, вы можете открыть проблему на GitHub, и она будет рассмотрена и решена как можно скорее. Ценные и качественные вклады приветствуются. Прежде чем работать над крупными функциями, которые вы планируете объединить, пожалуйста, сначала откройте одну из проблем, чтобы обсудить её заранее. Среда разработки работает за HTTPS на https://keeper.localhost с использованием Caddy reverse proxy с автоматическим TLS. Домен .localhost разрешается в 127.0.0.

Обзор (машинный перевод)

Keeper.sh — это простой и открытый инструмент синхронизации календарей. Он позволяет загружать события из Google Calendar, Outlook, iCloud, Fastmail, CalDAV сервера или удалённо размещённых iCal и ICS-каналов и отправлять их в один или несколько календарей, чтобы временные слоты совпадали между всеми ними. Google, Outlook, iCloud, Fastmail и CalDAV — это первоклассные интеграции, которые можно использовать как источник или как пункт назначения, тогда как iCal и ICS-ссылки доступны только для вытягивания. Он также служит глобальным MCP-сервером и API для вас или ваших агентов, чтобы управлять всеми календарями из одного удобного интерфейса.

Рекомендуемый способ запуска — это хостинговая версия по keeper.sh: тот же код, без сервера, домена, обновлений, резервных копий и приложений для входа Google и Microsoft, которые вы бы сами зарегистрировали. Самохостинг — это первоклассный путь, и при самостоятельном хостинге включены все функции Pro, это не пробный период и не исчезнет. Это стоит вам расходов на содержание вместо $5.

Особенности

Первоклассные интеграции с Google Calendar, Outlook, iCloud, Fastmail и CalDAV, каждая из которых может использоваться как источник или пункт назначения
Только подтягивание удалённо размещённых iCal и ICS каналов

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

docker run -d \

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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