# Keeper.sh (MCP server)

> Keeper.sh is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Calendar sync tool & universal calendar MCP server. It has 1,379 GitHub stars, is released under the AGPL-3.0 license and runs locally with docker run -i --rm ghcr.io/ridafkih/keeper-standalone.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/ridafkih/keeper.sh |
| GitHub stars | 1,379 |
| License | AGPL-3.0 |
| Language | TypeScript |
| Transport | stdio |
| Packages | docker: ghcr.io/ridafkih/keeper-standalone |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v2.24.6 (Sep 23, 2026) |
| Last commit | Sep 29, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "keeper-sh": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ridafkih/keeper-standalone"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio keeper-sh -- docker run -i --rm ghcr.io/ridafkih/keeper-standalone
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "keeper-sh": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ridafkih/keeper-standalone"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "keeper-sh": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ridafkih/keeper-standalone"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `list_calendars`: List all calendars connected to Keeper.sh, including provider name and account.
- `get_event_count`: Get the number of calendar events. Optionally scoped to a date range with from and to ISO 8601 datetimes.
- `get_events`: Get calendar events within a date range. Accepts ISO 8601 datetimes and an IANA timezone identifier used to localize…
- `get_event`: Get a single calendar event by its ID.
- `find_free_time`: Find open slots of at least a given duration across every synced calendar in a date range.
- `create_event`: Create an event on a connected calendar. Requires a calendar ID, title, start time, and end time.
- `update_event`: Update an existing calendar event. Only the fields you provide are updated.
- `delete_event`: Delete a calendar event by its ID.
- `get_pending_invites`: Get invitations on a calendar that have not been responded to within a date range.
- `rsvp_event`: Respond to a calendar event invitation with accepted, declined, or tentative.
- `list_accounts`: List all connected calendar accounts with provider information.
- `trigger_sync`: Force a sync now instead of waiting for the next scheduled run. Throttled to one request per minute.
- `pause_sync`: Pause or resume syncing for a single calendar without disconnecting it.
- `get_ical_feed`: Get your iCal feed URL for subscribing in other calendar apps.

## Similar MCP servers

- [Kaneo](https://appsgit.com/mcp-servers/kaneo): Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients. (9,368 stars, MIT, official, needs API key)
- [PraisonAI](https://appsgit.com/mcp-servers/praisonai): AI Agents Framework with Self Reflection and MCP support. (9,192 stars, MIT)
- [Windows MCP](https://appsgit.com/mcp-servers/windows-mcp): An MCP Server for computer-use in Windows OS. (7,725 stars, MIT)
- [Excel MCP Server](https://appsgit.com/mcp-servers/excel-mcp-server): Create, read and edit Excel workbooks without Microsoft Excel. (4,212 stars, MIT)
- [Basic Memory](https://appsgit.com/mcp-servers/basic-memory): Local-first knowledge management with bi-directional LLM sync via Markdown files. (4,108 stars, AGPL-3.0)
- [RevoGrid DataGrid MCP](https://appsgit.com/mcp-servers/revogrid-datagrid-mcp): Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval. (3,448 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/keeper-sh
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.