caldav

Manage CalDAV calendars, events, and todos with full recurrence rule support.

Updated May 10, 2026
One-click install
npx skills add https://github.com/cookkie03/skills --skill caldav-cookkie03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caldav
Source: https://github.com/cookkie03/skills/tree/main/caldav
Command: npx skills add https://github.com/cookkie03/skills --skill caldav-cookkie03

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires caldav, icalendar, python-dateutil, and includes scripts (resource) components.

What problem does it solve? Managing calendars and tasks across multiple providers (Synology, iCloud, Google, Fastmail, Nextcloud) requires dealing with the CalDAV protocol and iCalendar formats directly, which is tedious and error-prone without a unified client. ## Core Features & Use Cases - Event Management (VEVENT): List, create, update, and delete calendar events with support for attendees, locations, and statuses. - Task Management (VTODO): Create and track todos with priorities, due dates, completion states, and categories. - Recurrence Support (RRULE): Parse, generate, and expand recurrence rules like "FREQ=WEEKLY;BYDAY=MO" into concrete occurrence dates. - Use Case: Ask the assistant to create a weekly team standup every Monday at 9:00 on your Synology calendar, then list all incomplete tasks due this week. ## Quick Start Configure an account in ~/.config/openclaw/caldav.json, then ask the assistant to list my events for next week on my Synology calendar.

Frequently Asked Questions about caldav

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a recurring calendar event with CalDAV?

Call create_event with an rrule parameter such as "FREQ=WEEKLY;BYDAY=MO" to make the event repeat every Monday. The RRULE string follows the iCalendar standard and supports FREQ, INTERVAL, COUNT, UNTIL, BYDAY, and BYMONTHDAY.

How do I manage tasks with CalDAV VTODO?

Use create_todo with a summary, due date, and priority from 1 to 9, then track progress with list_todos filtered by status. You can mark tasks done with complete_todo or adjust urgency with set_todo_priority.

Which CalDAV servers does this client support?

The client works with Synology, iCloud, Google, Fastmail, and Nextcloud CalDAV endpoints. Synology URLs get the /caldav.php/{username}/ path appended automatically, while iCloud and Google require app-specific passwords.

Why do I get a 401 Unauthorized error connecting to CalDAV?

A 401 error means the username or password in ~/.config/openclaw/caldav.json is incorrect. For iCloud and Google, you must generate an app-specific password instead of using your main account password.

How do I calculate future dates from an RRULE recurrence string?

Use get_recurrence_dates with the RRULE string, a start date, and either an end date or a count. It returns ISO 8601 datetime strings for each occurrence, and EXDATE values are excluded when expanding events.