Skip to content

Calendar (CalDAV)

The Calendar integration connects one CalDAV account: iCloud, Fastmail, Nextcloud, or any CalDAV server. Credentials are stored encrypted and never reach the agent container; agents go through your vonzio server, which talks to CalDAV on their behalf.

In the dashboard: Settings → Integrations → Calendar → “Connect calendar”. Pick a preset (iCloud, Fastmail, Nextcloud) or “Custom (CalDAV)”, then enter the CalDAV URL, your username, and an app password (iCloud and Fastmail require one; your normal password won’t work).

Vonzio logs in and lists your calendars before saving. If that fails, you get the error in the dialog and nothing is stored.

API alternative:

POST /v1/integrations
{
"type": "calendar",
"config": {
"caldav_url": "https://caldav.fastmail.com/dav/",
"username": "you@example.com",
"password": "app-password"
}
}

The URL must be https://, and hosts that resolve to private or internal addresses are refused.

When a Calendar integration is granted to the running profile, the agent gets a calendar MCP server (mcp__calendar__*):

ToolWhat it does
calendar_listList your calendars (name and URL).
calendar_eventsList upcoming events across calendars, or one calendar. Default next 7 days (max 90), 25 events (max 100).
calendar_create_eventCreate a single timed event (title, ISO-8601 start/end, optional location and description) on the first or a named calendar.
calendar_delete_eventDelete an event by the object URL returned from calendar_events.