cal-mcp

CalDAV MCP server and CLI for Radicale. Manages calendar events and reminders (VTODOs).

Works with any CalDAV server (Radicale, Nextcloud, etc.) via raw HTTP — no heavy caldav library dependency.

Install

pip install .

MCP Server

cal-mcp

Starts on stdio transport with tools: list_events, add_event, delete_event, list_reminders, add_reminder, delete_reminder.

Configuration

Set environment variables:

Variable	Description	Example
CALDAV_URL	CalDAV server base URL	https://raspberrypi.local:5232
CALDAV_USER	Username	allen
CALDAV_PASSWORD	Password	secret
CALDAV_CALENDAR	Calendar collection path	allen/calendar.ics
CALDAV_REMINDERS	Reminders collection path	allen/reminders
CALDAV_VERIFY_SSL	Verify TLS certs (default: true)	false

Or provide a JSON config file via CAL_CONFIG env var:

{
  "server": "https://raspberrypi.local:5232",
  "user": "allen",
  "password": "secret",
  "calendar": "allen/calendar.ics",
  "reminders": "allen/reminders",
  "verify_ssl": false
}

CLI

cal add --title "交作文" --start "2026-04-30 09:00" --alarm 30m
cal remind --title "交作文" --due "2026-04-30 09:00"
cal list --days 7
cal delete --uid <event-uid>

Datetime parsing supports: YYYY-MM-DD HH:MM, tomorrow 09:00, today 15:00.

License

MIT