# Jmap Calendar MCP

> Jmap Calendar MCP is an open-source MCP server for productivity. Let an AI agent read and edit calendars on any JMAP server such as Stalwart. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/robertdoneill/jmap-calendar-mcp
- **MCP Registry name:** io.github.robertdoneill/jmap-calendar-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

This is a single Python file using only the standard library, installed with uvx. It talks to any server that supports JMAP for Calendars, with Stalwart 1.0 and later named as an example, and expands recurring events when searching a time range (the next 30 days by default).

It is designed to be safe to hand to an agent. Deletion is off unless `JMAP_ALLOW_DELETE=1` is set, and then it removes every occurrence of a repeating event without sending cancellations. Attendees are added without being emailed unless the server has `JMAP_ALLOW_INVITES=1` and the call also sets `send_invitations: true`.

The README walks through creating an API key on Stalwart limited to calendar permissions, so the agent cannot read or send mail with it. For several accounts, add one server entry per account, such as calendar-work and calendar-home. It is MIT licensed.

## Features

- **Recurring-event expansion:** Searching a time range returns each occurrence of repeating events, optionally filtered by text.
- **Create events:** Set a title, start, time zone, length or all-day, description, location and attendees.
- **Partial updates:** Change only the given fields of an event, or move it to another calendar.
- **Opt-in delete:** The delete tool is only offered when an environment variable enables it.
- **Opt-in invitations:** Invitations need both a server setting and a flag on the individual call.
- **Calendar-only keys:** Setup guidance limits the API key to calendar permissions so mail stays out of reach.

## Good for

- Ask an agent what is on your calendar this week
- Schedule a meeting with a time zone and location
- Move an event to another calendar
- Search events for a keyword
- Run separate agents for work and home calendars

## Install

### Claude Code (Terminal)

```sh
claude mcp add jmap-calendar-mcp --env JMAP_SESSION_URL='<JMAP_SESSION_URL>' --env JMAP_BEARER_TOKEN='<JMAP_BEARER_TOKEN>' -- uvx jmap-calendar-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "jmap-calendar-mcp": {
      "command": "uvx",
      "args": [
        "jmap-calendar-mcp"
      ],
      "env": {
        "JMAP_SESSION_URL": "<JMAP_SESSION_URL>",
        "JMAP_BEARER_TOKEN": "<JMAP_BEARER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jmap-calendar-mcp": {
      "command": "uvx",
      "args": [
        "jmap-calendar-mcp"
      ],
      "env": {
        "JMAP_SESSION_URL": "<JMAP_SESSION_URL>",
        "JMAP_BEARER_TOKEN": "<JMAP_BEARER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "jmap-calendar-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "jmap-calendar-mcp"
      ],
      "env": {
        "JMAP_SESSION_URL": "<JMAP_SESSION_URL>",
        "JMAP_BEARER_TOKEN": "<JMAP_BEARER_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "jmap-calendar-mcp": {
      "command": "uvx",
      "args": [
        "jmap-calendar-mcp"
      ],
      "env": {
        "JMAP_SESSION_URL": "<JMAP_SESSION_URL>",
        "JMAP_BEARER_TOKEN": "<JMAP_BEARER_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "jmap-calendar-mcp": {
      "command": "uvx",
      "args": [
        "jmap-calendar-mcp"
      ],
      "env": {
        "JMAP_SESSION_URL": "<JMAP_SESSION_URL>",
        "JMAP_BEARER_TOKEN": "<JMAP_BEARER_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_calendars`: List the account's calendars and show which one is the default.
- `find_calendar_events`: Find events in a time range, optionally matching text, with recurring events expanded.
- `create_calendar_event`: Create an event with title, start, time zone, length or all-day, description, location and attendees.
- `update_calendar_event`: Change given fields of an event or move it to another calendar.
- `delete_calendar_event`: Delete an event and every occurrence; only offered when JMAP_ALLOW_DELETE=1.

## FAQ

### Which servers does it work with?

Any JMAP server that supports JMAP for Calendars, such as Stalwart 1.0 and later.

### Can the agent delete events?

Only if you set JMAP_ALLOW_DELETE=1, which adds the delete_calendar_event tool; it sends no cancellations.

### Will attendees be emailed?

Not by default. Invitations need JMAP_ALLOW_INVITES=1 on the server and send_invitations: true on the call.

### How do I use several accounts?

Add one server entry per account, for example calendar-work and calendar-home.

### Is Jmap Calendar MCP free?

Yes. Jmap Calendar MCP is open source, so you can use and self-host it for free.

### How do I add Jmap Calendar MCP to Claude Code?

Run this command in your terminal: claude mcp add jmap-calendar-mcp --env JMAP_SESSION_URL='<JMAP_SESSION_URL>' --env JMAP_BEARER_TOKEN='<JMAP_BEARER_TOKEN>' -- uvx jmap-calendar-mcp

### What are the best alternatives to Jmap Calendar MCP?

The closest alternatives to Jmap Calendar MCP are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.
- [Google_calendar](https://ai-powered.com/mcp/google-calendar-3): Google_calendar is a freemium MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/jmap-calendar-mcp
