Skip to content
MCP server

Jmap Calendar MCP

Let an AI agent read and edit calendars on any JMAP server such as Stalwart

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
today

Similar MCP servers

About Jmap Calendar MCP

Jmap Calendar MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • JMAP_SESSION_URLJMAP session URL, usually https://<host>/.well-known/jmapRequired
  • JMAP_BEARER_TOKENAPI key for the account, limited to calendar permissionsRequired
  • JMAP_ALLOW_INVITES1 to allow sending invitations when a call asks for it
  • JMAP_ALLOW_DELETE1 to offer delete_calendar_event

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence

Jmap Calendar MCP 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.

How AIPoweredBot checks servers