CalDAV MCP Server
Provides full CRUD operations on calendar events, free/busy, and availability-finding for Google Calendar.
Provides full CRUD operations on calendar events, free/busy, and availability-finding for iCloud calendars.
Provides full CRUD operations on calendar events, free/busy, and availability-finding for mailbox.org calendars.
Provides full CRUD operations on calendar events, free/busy, and availability-finding for Nextcloud calendars.
Provides full CRUD operations on calendar events, free/busy, and availability-finding for Synology Calendar.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CalDAV MCP Server list my calendars"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.mainRelated 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 |
| Yes | — | Full CalDAV server URL |
| Yes | — | Login username |
| Yes | — | Password or app-specific token |
| No | — | Server compatibility profile |
| No |
| Set to |
| No |
| HTTP request timeout in seconds |
Tools
Tool | Description |
| List all calendars on the server with names, URLs, and supported component types |
| Search events by date range with optional text filtering |
| Get full details of a single event by UID (summary, times, description, location, attendees, recurrence) |
| Create a new event with optional recurrence rules, attendees, and reminders |
| Update fields on an existing event (only specified fields are changed) |
| Permanently delete an event by UID |
| Get busy time slots in a date range (falls back to event search if server doesn't support free/busy) |
| 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, FridayFREQ=MONTHLY;BYMONTHDAY=15— 15th of every monthFREQ=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 |
| Radicale |
| Baikal |
| Fastmail |
| Apple iCloud |
| Google Calendar |
| Zimbra |
| SOGo |
| Posteo |
| Open-Xchange / mailbox.org |
| Synology Calendar |
iCloud Setup
Generate an app-specific password at appleid.apple.com
Set
CALDAV_URL=https://caldav.icloud.comSet
CALDAV_USERNAMEto your Apple ID emailSet
CALDAV_PASSWORDto the generated app-specific passwordSet
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 emptyProject 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__.pyLicense
MIT
Available Tools
8 toolscalendar_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
Scored across 8 tools
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.
All tools follow the pattern `calendar_verb_noun` with consistent snake_case. Very predictable and clear.
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.
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
Related MCP Connectors
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
EU-hosted calendar MCP: Google, Outlook, iCloud, GMX, WEB.DE, CalDAV. Read, book, RSVP, sync.
Sync Google, Outlook, and iCloud calendars and manage events, availability, and booking links.
Calendar sync management on every plan; calendar events on Plus, Pro and Team. OAuth 2.0 + PKCE.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables CRUD operations for calendar events, journal entries, and todos on any CalDAV server (like Radicale) through the Model Communication Protocol.MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- FlicenseNot gradedqualityDmaintenanceEnables LLM agents to read, schedule, update, and delete calendar events and tasks on a self-hosted CalDAV server, and to query availability for free/busy slots.1-
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmMIT