CalDAV

Exposes CalDAV calendar operations as MCP tools to create events and list events within a timeframe.

typescript

39

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can expose CalDAV calendar operations as executable tools for AI assistants using this MCP server. It lets you connect to a CalDAV server, create events, and list events within a timeframe, so you can automate calendar management through your preferred MCP client.

How to use

Use an MCP client to interact with the calendar MCP server. You will reference the calendar tool named calendar to perform operations such as creating events and listing upcoming events. Authenticate by providing the CalDAV server credentials via the configured environment variables. The server exposes two primary actions you can call through your MCP client: creating an event and listing events within a specified timeframe.

How to install

Prerequisites you need before installation:

Node.js installed on your machine. Ensure you have a recent LTS version.
A working CalDAV server and credentials to access it.

Steps to set up and run the MCP calendar server locally:

# 1. Compile TypeScript to JavaScript
npx tsc

# 2. Run the MCP server
node index.js

Configuration and usage notes

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

Security and environment

Protect credentials used to access the CalDAV server. Treat CALDAV_BASE_URL, CALDAV_USERNAME, and CALDAV_PASSWORD as sensitive information. Store them securely and rotate credentials periodically.

Available tools

create-event

Creates a new calendar event with a title (summary) and start/end times. Returns the unique ID of the created event.

list-events

Lists events within a specified start and end timeframe and returns matching event summaries.