Keeper.sh

Active
GitHub TypeScript AGPL-3.0

Description

Calendar sync tool and universal calendar MCP server for aggregating, syncing, and controlling calendars across Google, Outlook, Office 365, iCloud, and CalDAV.

Key Features

  • Aggregate calendar events from remote iCal or ICS links across multiple sources
  • Content-agnostic syncing engine with smart push and automatic stale event cleanup
  • MCP server integration allowing AI agents to read and write calendars directly
  • Self-hostable with all Pro features available for free
  • Supports Google, Outlook, Office 365, iCloud, and CalDAV calendar platforms
  • One-click Docker deployment with Web, API, Worker, and MCP service architecture

Use Cases

πŸ’‘ Personal multi-calendar management: merge work, life, and personal calendars to avoid scheduling conflicts
πŸ’‘ AI agent scheduling automation: let AI assistants query and create events via MCP
πŸ’‘ Team calendar syncing: aggregate team members' shared calendars into a unified view
πŸ’‘ Cross-platform calendar migration: sync Outlook calendar events to Google Calendar
πŸ’‘ SaaS deployment: deploy a cloud-hosted version to offer paid calendar sync services

Quick Start

1. Install Bun v1.3.11+ and Docker Compose;
2. Clone the repo and run `bun install`;
3. Generate and trust a local root CA certificate (macOS: `sudo security add-trusted-cert`; Linux: copy to `/usr/local/share/ca-certificates/` and run `update-ca-certificates`);
4. Run `bun dev` to start the full dev environment (PostgreSQL, Redis, Caddy reverse proxy, API, Web, MCP services);
5. Open `https://keeper.localhost` to start using Keeper.

Related Projects