# Keeper.sh

Keeper.sh syncs events across calendars and gives AI agents MCP access to them. Use it when you need calendars to share availability or want an agent to work with events.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1477 repo stars
- Author: ridafkih
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ridafkih/keeper.sh
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/keepersh

## What it does

Keeper.sh can pull from and push events to Google Calendar, Outlook, iCloud, Fastmail, and CalDAV. Hosted iCal and ICS links work as sources only. Events are collected in Keeper.sh, then sent to one or more destination calendars.

The MCP server exposes calendar access to AI agents. Keeper.sh also offers a token-authenticated REST API and a combined iCal feed. Privacy controls can remove event titles, descriptions, or locations and replace the title with a template. When a source event disappears, its mapped copy can be removed from the destination; cleanup only targets events Keeper.sh created. Google and Outlook use provider change tracking, while other sources are fetched again and compared with saved event state.

Claude Code connects to the hosted MCP endpoint over HTTP. Calendar syncing depends on the calendars connected to Keeper.sh and its configuration.

## Requirements
- Remote server: `https://www.keeper.sh/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http keeper-sh https://www.keeper.sh/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add keepersh --url https://www.keeper.sh/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "keepersh": {
            "url": "https://www.keeper.sh/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "keepersh": {
            "type": "http",
            "url": "https://www.keeper.sh/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http keepersh https://www.keeper.sh/mcp
```

## When to use it
- keep availability aligned across several calendars
- copy events from Google Calendar to destination calendars
- remove destination copies after source events are deleted
- hide event details before syncing them

## Example prompts
- Find an open time across my connected calendars and suggest a meeting slot.
- Add this meeting to a destination calendar and sync it with my other calendars.
- Trigger a calendar sync through Keeper.sh.

## Similar
- [Chronary](https://affpapa.org/en/nevibecode/mcp/chronary.md) — MCP server
- [gws-calendar](https://affpapa.org/en/nevibecode/skills/gws-calendar.md) — skill · 64100 installs
- [google-calendar](https://affpapa.org/en/nevibecode/skills/membrane-google-calendar.md) — skill · 337 installs
- [gccli](https://affpapa.org/en/nevibecode/skills/gccli.md) — skill · 177 installs
- [Google Calendar](https://affpapa.org/en/nevibecode/mcp/googlecalendar-google-calendar.md) — MCP server · 15718 installs
- [calendar-mcp](https://affpapa.org/en/nevibecode/mcp/calendar-mcp.md) — MCP server · ★ 27 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
