CalDAV MCP, MCP server

CalDAV MCP

View on GitHub

How to install it

It runs on your machine and needs Node.js. Configuration taken from the official MCP registry.

In a terminal:

claude mcp add --env CALDAV_BASE_URL=YOUR_VALUE --env CALDAV_USERNAME=YOUR_VALUE --env CALDAV_PASSWORD=YOUR_VALUE --transport stdio caldav-mcp -- npx -y caldav-mcp

In ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

{
    "mcpServers": {
        "caldav-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "caldav-mcp"
            ],
            "env": {
                "CALDAV_BASE_URL": "YOUR_VALUE",
                "CALDAV_USERNAME": "YOUR_VALUE",
                "CALDAV_PASSWORD": "YOUR_VALUE"
            }
        }
    }
}

If the file already lists other servers, add only this entry inside the list.

In your project's .vscode/mcp.json:

{
    "servers": {
        "caldav-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "caldav-mcp"
            ],
            "env": {
                "CALDAV_BASE_URL": "YOUR_VALUE",
                "CALDAV_USERNAME": "YOUR_VALUE",
                "CALDAV_PASSWORD": "YOUR_VALUE"
            }
        }
    }
}

If the file already lists other servers, add only this entry inside the list.

In claude_desktop_config.json (macOS: ~/Library/Application Support/Claude; Windows: %APPDATA%\Claude), then restart Claude:

{
    "mcpServers": {
        "caldav-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "caldav-mcp"
            ],
            "env": {
                "CALDAV_BASE_URL": "YOUR_VALUE",
                "CALDAV_USERNAME": "YOUR_VALUE",
                "CALDAV_PASSWORD": "YOUR_VALUE"
            }
        }
    }
}

If the file already lists other servers, add only this entry inside the list.

Replace YOUR_VALUE with your keys, and do not commit the file with them to a repository.

This is third-party software that ALMC has not reviewed: read it before giving it access to your data.

Want it in your company, with permissions configured and a tested use case? We install it for you

caldav-mcp

🗓️ A CalDAV Model Context Protocol (MCP) server to expose calendar operations as tools for AI assistants.

MIT Licensecode style: prettierMCP Compatiblesemantic-release: angular

✨ Features

  • Connect to CalDAV servers
  • Create calendar events
  • List calendar events within a specific timeframe

Setup

{
  "mcpServers": {
    ...,
    "calendar": {
      "command": "npx",
      "args": [
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"
      }
    }
  }
}

Usage

  1. Compile TypeScript to JavaScript:
npx tsc
  1. Run the MCP server:
node index.js

Available Tools

create-event

Creates a new calendar event.

Parameters:

  • summary: String - Event title/summary
  • start: DateTime string - Event start time
  • end: DateTime string - Event end time

Returns:

  • The unique ID of the created event

list-events

Lists events within a specified timeframe.

Parameters:

  • start: DateTime string - Start of the timeframe
  • end: DateTime string - End of the timeframe

Returns:

  • A list of event summaries that fall within the given timeframe

License

MIT

We install and manage your MCP server

Our team configures, deploys and maintains MCP servers tailored to your infrastructure.

  • Professional installation & configuration
  • Integration with your existing systems
  • Ongoing technical support & maintenance
  • Custom security & auditing

Response within 24h · No commitment

Quick MCP enquiry

Related in Productivity - MCP servers