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
• Delete calendar events

Setup

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

Development

1. Compile TypeScript to JavaScript:

npx tsc

2. Run the MCP server:

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

Returns:

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

list-calendars

Lists all available calendars.

Parameters: none

Returns:

• List of all available calendars

delete-event

Deletes an event in the calendar specified by its URL

Parameters:

• uid: string - The UID of the calendar event to delete
• calendarUrl: string - the URL of the calendar event to delete

License

MIT