Skip to content
appsgit

Caldav MCP

Caldav MCP is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. CalDAV calendar operations (list, create, update, delete events) as MCP tools. It has 103 GitHub stars, is released under the MIT license and runs locally with npx -y caldav-mcp.

github.com/dominik1001/caldav-mcp (opens in a new tab)

Install Caldav MCP

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "caldav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "your-value",
        "CALDAV_USERNAME": "your-value",
        "CALDAV_PASSWORD": "your-value"
      }
    }
  }
}

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

Claude Code

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

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "caldav-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "your-value",
        "CALDAV_USERNAME": "your-value",
        "CALDAV_PASSWORD": "your-value"
      }
    }
  }
}

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

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "caldav_password",
      "description": "CALDAV_PASSWORD",
      "password": true
    }
  ],
  "servers": {
    "caldav-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "caldav-mcp"
      ],
      "env": {
        "CALDAV_BASE_URL": "your-value",
        "CALDAV_USERNAME": "your-value",
        "CALDAV_PASSWORD": "${input:caldav_password}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
CALDAV_BASE_URLYesBase URL of the CalDAV server (e.g. https://caldav.example.com)
CALDAV_USERNAMEYesUsername for CalDAV authentication
CALDAV_PASSWORDsecretYesPassword for CalDAV authentication

Tools (25)

Parsed from the Tools section of the README; check the repository for the current list.

  • list-calendars

    List all calendars returning both name and URL

  • list-events

    List all events between start and end date in the calendar specified by its URL

  • start

    string β€” Start date (ISO 8601)

  • create-event

    Creates an event in the calendar specified by its URL. For all-day events, set wholeDay to true.

  • summary

    string

  • location

    string (optional)

  • freq

    enum (DAILY | WEEKLY | MONTHLY | YEARLY) (optional)

  • interval

    number (optional)

  • count

    number (optional)

  • until

    string (optional)

  • byday

    array of string (optional)

  • bymonthday

    array of number (optional)

  • bymonth

    array of number (optional)

  • update-event

    Updates an existing event in the calendar specified by its URL. Only provided fields are changed.

  • delete-event

    Deletes an event in the calendar specified by its URL

  • list-todos

    List tasks (VTODOs) in the calendar specified by its URL. By default returns only open tasks (NEEDS-ACTION and…

  • status

    enum (OPEN | ALL | NEEDS-ACTION | COMPLETED | IN-PROCESS | CANCELLED) (optional) β€” Filter by status.

  • due_before

    string (optional) β€” Only tasks with a due date at or before this (ISO 8601).

  • due_after

    string (optional) β€” Only tasks with a due date at or after this (ISO 8601).

  • limit

    number (optional) β€” Max tasks to return (default 50, max 500)

  • offset

    number (optional) β€” Tasks to skip (default 0)

  • create-todo

    Creates a task (VTODO) in the calendar specified by its URL. Only summary is required; a task may have no dates.

  • update-todo

    Updates an existing task (VTODO) in the calendar specified by its URL. Only provided fields are changed.

  • complete-todo

    Marks a task (VTODO) as done. Sets its status to COMPLETED and records the completion time.

  • delete-todo

    Deletes a task (VTODO) in the calendar specified by its URL

About Caldav MCP

πŸ—“οΈ A CalDAV Model Context Protocol (MCP) server to expose calendar operations as tools for AI assistants. Run the MCP server in development mode with auto-reload:

  • caldav
  • mcp-server
  • typescript
  • mcp

FAQ

Caldav MCP FAQ

Still curious? Email info@appsgit.com.

What is Caldav MCP?

Caldav MCP is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. CalDAV calendar operations (list, create, update, delete events) as MCP tools. It has 103 GitHub stars, is released under the MIT license and runs locally with npx -y caldav-mcp. The source code is at github.com/dominik1001/caldav-mcp.

How do I install the Caldav MCP MCP server?

Add the command npx -y caldav-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Caldav MCP free?

The server is open source under the MIT license, so running it is free. It needs credentials (CALDAV_PASSWORD) for the service it connects to, which may require a paid account.

Is Caldav MCP actively maintained?

The most recent commit was on Sep 15, 2026. The latest release is v0.10.0, published Jul 1, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.