caldav-mcp

• Connect to CalDAV servers
• List calendars
• List calendar events within a specific timeframe
• Create calendar events
• Update calendar events
• Delete calendar events by UID

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

Run the MCP server in development mode with auto-reload:

npm run dev

This will run the TypeScript code directly with watch mode and automatically load environment variables from .env.

Alternatively, you can compile TypeScript to JavaScript and run it:

1. Compile:

npx tsc

2. Run:

node dist/index.js

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

Lists events within a specified timeframe.

Parameters:

• start: DateTime string - Start of the timeframe
• end: DateTime string - End of the timeframe
• calendarUrl: String - URL of the calendar

Returns:

• A list of events that fall within the given timeframe, each containing:
  • uid: Unique identifier for the event (required for deletion)
  • summary: Event title/summary
  • start: Event start time
  • end: Event end time

Updates an existing calendar event. Only provided fields are changed.

Parameters:

• uid: String - Unique identifier of the event to update (obtained from list-events)
• calendarUrl: String - URL of the calendar
• summary: String (optional) - New event title/summary
• start: DateTime string (optional) - New event start time
• end: DateTime string (optional) - New event end time
• description: String (optional) - New event description
• location: String (optional) - New event location
• recurrenceRule: Object (optional) - New recurrence rule

Returns:

• The unique ID of the updated event

Deletes an event from the calendar.

Parameters:

• uid: String - Unique identifier of the event to delete (obtained from list-events)
• calendarUrl: String - URL of the calendar

Returns:

• Confirmation message when the event is successfully deleted

Lists all available calendars.

Parameters: none

Returns:

• List of all available calendars

MIT