Calendar

List all CalDAV accounts configured for the user, including their linked mail account (used as Organizer when sending invites).

List all calendars (collections) for a specific CalDAV account. Use this to find the calendar_id needed for create_event.

List calendar events in a given time window. Use this to answer questions like "what are my meetings next week?" or to check what is scheduled before proposing a time.

Fetch a single event by ID, including its attendeeList with RSVP status (partstat: ACCEPTED/DECLINED/TENTATIVE/NEEDS-ACTION).

Find free time slots in the user's calendar matching a desired duration and working hours. CALL THIS BEFORE proposing meeting times to someone via mail_send — it returns open slots that do not conflict with existing events. Honors RRULE recurrences and working-hours/days filters.

Create a new event in a specific calendar. Pass attendees with send_invites=true to have the CalDAV server automatically dispatch iTIP invitation emails (method=REQUEST). The account must have a linked mail account (see calendar_list_accounts.linkedMailAccountId) for invites to be sent.

Update an existing event. Pass only the fields you want to change. Providing `attendees` REPLACES the full attendee list. The SEQUENCE is auto-incremented so attendees get a proper iTIP UPDATE when send_invites=true.

Delete an event. If attendees are present, a METHOD:CANCEL iTIP notification is sent automatically before deletion.

Re-send iTIP REQUEST invitations to all attendees of an existing event. Useful when an attendee has not received the original invite. The SEQUENCE is incremented.

Trigger a CalDAV sync for a specific account. Fetches calendar collections and new/updated events from the server.