caldav-mcp

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

✨ Features

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

Setup

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

Development

Quick Start

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.

Manual Build

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

1. Compile:

npx tsc

1. Run:

node dist/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
• 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

update-event

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

delete-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

list-calendars

Lists all available calendars.

Parameters: none

Returns:

• List of all available calendars

License

MIT