Jmap Calendar MCP
Let an AI agent read and edit calendars on any JMAP server such as Stalwart
- 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-mcpAdd 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/jmapRequiredJMAP_BEARER_TOKENAPI key for the account, limited to calendar permissionsRequiredJMAP_ALLOW_INVITES1 to allow sending invitations when a call asks for itJMAP_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.
