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.
What agents get
Section titled “What agents get”When a Calendar integration is granted to the running profile, the agent gets a calendar MCP server (mcp__calendar__*):
| Tool | What it does |
|---|---|
calendar_list | List your calendars (name and URL). |
calendar_events | List upcoming events across calendars, or one calendar. Default next 7 days (max 90), 25 events (max 100). |
calendar_create_event | Create a single timed event (title, ISO-8601 start/end, optional location and description) on the first or a named calendar. |
calendar_delete_event | Delete an event by the object URL returned from calendar_events. |