Skip to main content
Glama

CalDAV MCP Server

MCP (Model Context Protocol) server for interacting with CalDAV calendars. Provides full CRUD operations on calendar events plus free/busy and availability-finding tools.

Supports Nextcloud, Radicale, Fastmail, iCloud, Baikal, Zimbra, SOGo, and any RFC 4791-compliant CalDAV server.

Quick Start

# Install
cd caldav-mcp-server
pip install -e .

# Configure
export CALDAV_URL="https://your-server.com/remote.php/dav/"
export CALDAV_USERNAME="your-username"
export CALDAV_PASSWORD="your-password"

# Run
caldav-mcp-server
# or: python -m caldav_mcp_server.main

Related MCP server: CalDAV MCP Server

Claude Code Integration

Add to ~/.claude.json in the mcpServers section:

{
  "mcpServers": {
    "caldav": {
      "command": "python",
      "args": ["-m", "caldav_mcp_server.main"],
      "cwd": "/Users/jiangwu/claude/caldav-mcp-server/src",
      "env": {
        "CALDAV_URL": "https://your-server.com/remote.php/dav/",
        "CALDAV_USERNAME": "your-username",
        "CALDAV_PASSWORD": "your-password",
        "CALDAV_FEATURES": "nextcloud"
      }
    }
  }
}

Environment Variables

Variable

Required

Default

Description

CALDAV_URL

Yes

—

Full CalDAV server URL

CALDAV_USERNAME

Yes

—

Login username

CALDAV_PASSWORD

Yes

—

Password or app-specific token

CALDAV_FEATURES

No

—

Server compatibility profile

CALDAV_SSL_VERIFY_CERT

No

true

Set to false for self-signed certs, or path to CA bundle

CALDAV_TIMEOUT

No

30

HTTP request timeout in seconds

Tools

Tool

Description

calendar_list_calendars

List all calendars on the server with names, URLs, and supported component types

calendar_search_events

Search events by date range with optional text filtering

calendar_get_event

Get full details of a single event by UID (summary, times, description, location, attendees, recurrence)

calendar_create_event

Create a new event with optional recurrence rules, attendees, and reminders

calendar_update_event

Update fields on an existing event (only specified fields are changed)

calendar_delete_event

Permanently delete an event by UID

calendar_get_freebusy

Get busy time slots in a date range (falls back to event search if server doesn't support free/busy)

calendar_find_available_slots

Find free time slots for scheduling, with optional working hours/days constraints

Time Format

All times use ISO 8601 format: 2026-01-15T09:00:00 or 2026-01-15T09:00:00+02:00. Times without a timezone offset are treated as UTC.

Recurrence Rules

The rrule parameter accepts RFC 5545 recurrence rule strings:

  • FREQ=WEEKLY;BYDAY=MO,WE,FR — every Monday, Wednesday, Friday

  • FREQ=MONTHLY;BYMONTHDAY=15 — 15th of every month

  • FREQ=DAILY;COUNT=10 — every day for 10 occurrences

Server Compatibility

Set CALDAV_FEATURES to one of these profiles to enable server-specific workarounds:

Profile

Servers

nextcloud

Nextcloud

radicale

Radicale

baikal

Baikal

fastmail

Fastmail

icloud

Apple iCloud

google

Google Calendar

zimbra

Zimbra

sogo

SOGo

posteo

Posteo

ox

Open-Xchange / mailbox.org

synology

Synology Calendar

iCloud Setup

  1. Generate an app-specific password at appleid.apple.com

  2. Set CALDAV_URL=https://caldav.icloud.com

  3. Set CALDAV_USERNAME to your Apple ID email

  4. Set CALDAV_PASSWORD to the generated app-specific password

  5. Set CALDAV_FEATURES=icloud

iCloud limitations: no recurring event expansion, no todos, no free/busy, no calendar creation.

Local Testing with Radicale

pip install radicale
radicale --storage-type filesystem --filesystem-folder /tmp/radicale
# Server runs at http://localhost:5232
# No auth by default — leave CALDAV_USERNAME and CALDAV_PASSWORD empty

Project Structure

caldav-mcp-server/
├── pyproject.toml
├── README.md
├── src/
│   └── caldav_mcp_server/
│       ├── __init__.py
│       ├── main.py          # FastMCP entry point + 8 tools
│       ├── auth.py          # Client factory + calendar resolution
│       ├── config.py        # Pydantic settings from env vars
│       ├── errors.py        # Error mapping + decorator
│       └── formatters.py    # Markdown + JSON output formatters
└── tests/
    └── __init__.py

License

MIT

Available Tools

8 tools
calendar_create_eventA

Create a new calendar event.

Args: calendar_id: Target calendar name or URL path summary: Event title start: ISO 8601 start time (e.g., "2026-01-15T09:00:00") end: ISO 8601 end time description: Optional event notes/description location: Optional physical or virtual location timezone: IANA timezone name (default "UTC", e.g., "America/New_York") rrule: Optional RFC 5545 recurrence rule (e.g., "FREQ=WEEKLY;BYDAY=MO,WE,FR") attendees: Optional comma-separated email addresses alarm_minutes: Optional comma-separated minutes-before reminders (e.g., "-30,-10")

Returns the UID of the created event. Save this for later updates or deletion.

Inputs: end (required), start (required), summary (required), calendar_id (required), +6 more. Returns: result

calendar_delete_eventA

Delete a calendar event by its UID.

WARNING: This operation cannot be undone. For recurring events, this deletes the entire series.

Args: calendar_id: Target calendar name or URL path event_uid: UID of the event to delete

Inputs: event_uid (required), calendar_id (required). Returns: result

calendar_find_available_slotsA

Find available (free) time slots for scheduling new events.

Args: calendar_id: Calendar name or URL path start: ISO 8601 start of search window end: ISO 8601 end of search window duration_minutes: Desired meeting duration in minutes (default 60) working_hours_start: Optional ISO time like "09:00" to constrain to working hours working_hours_end: Optional ISO time like "17:00" to constrain to working hours working_days: Optional comma-separated day abbreviations (e.g., "MO,TU,WE,TH,FR")

Returns up to 20 available slots sorted chronologically.

Inputs: end (required), start (required), calendar_id (required), working_days, +3 more. Returns: result

calendar_get_eventA

Get detailed information about a single calendar event by its UID.

Args: calendar_id: Calendar name or URL path event_uid: Unique identifier of the event (from calendar_search_events)

Returns all event properties: summary, start/end, description, location, recurrence rules, attendees, and organizer.

Inputs: event_uid (required), calendar_id (required). Returns: result

calendar_get_freebusyA

Get busy time slots from a calendar within a time range.

Args: calendar_id: Calendar name or URL path start: ISO 8601 start of the window (e.g., "2026-01-15T00:00:00") end: ISO 8601 end of the window

Returns a list of busy periods with start and end times. Use this to check for scheduling conflicts before creating events.

Inputs: end (required), start (required), calendar_id (required). Returns: result

calendar_list_calendarsA

List all calendars available on the configured CalDAV server.

Returns calendar name, URL path, and supported component types (VEVENT, VTODO, VJOURNAL) for each calendar. Use this first to discover what calendars are available before searching or creating events.

Inputs: no named parameters. Returns: result

calendar_search_eventsA

Search for events in a calendar within a date range.

Args: calendar_id: Calendar name or URL path (from calendar_list_calendars) start: ISO 8601 start datetime (e.g., "2026-01-01T00:00:00") end: ISO 8601 end datetime query: Optional text to search in event summary and description limit: Maximum number of results (default 50)

Returns events with UID, summary, start/end times, location, and status. Use UIDs from results for calendar_get_event, calendar_update_event, or calendar_delete_event.

Inputs: end (required), start (required), calendar_id (required), limit, +1 more. Returns: result

calendar_update_eventA

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

Args: calendar_id: Target calendar name or URL path event_uid: UID of the event to update summary: New event title (omit to keep unchanged) start: New ISO 8601 start time (omit to keep unchanged) end: New ISO 8601 end time (omit to keep unchanged) description: New description (omit to keep unchanged) location: New location (omit to keep unchanged)

Use calendar_get_event first to see current values.

Inputs: event_uid (required), calendar_id (required), end, start, +3 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct action (create, delete, get, update, search, list calendars, find slots, get free/busy). No overlap; even the two availability tools are complementary.

    Naming Consistency5/5

    All tools follow the pattern `calendar_verb_noun` with consistent snake_case. Very predictable and clear.

    Tool Count5/5

    With 8 tools, the surface is well-scoped for a CalDAV server: covers calendar discovery, CRUD, search, and availability checks. Not too many or too few.

    Completeness4/5

    Event management is fully covered (CRUD + search + availability). However, missing tools for VTODO and VJOURNAL, despite `calendar_list_calendars` reporting them as supported component types.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with any CalDAV-compatible calendar server (Yandex, Google, Nextcloud, iCloud, etc.) to list calendars, create/manage events with reminders and attendees, search events, and handle recurring events through natural language.
      15
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to connect to CalDAV servers to list calendars and events, create, update, and delete calendar events, and manage tasks (VTODOs) including listing, creating, updating, completing, and deleting them.
      693 npm
      MIT