A command-line tool and AI agent skill for managing calendars, events, and tasks across multiple CalDAV providers like Google Calendar, iCloud, and Nextcloud.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install caldav-sync
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install caldav-sync using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is CalDAV Sync Tool?
The CalDAV Sync Tool is a robust, developer-first utility designed to bridge command-line environments and AI agents with standard calendar services. As part of the ecosystem of Openclaw Skills, it allows seamless synchronization and manipulation of calendar events and todo tasks using the industry-standard CalDAV protocol. Whether you are building an automated personal assistant or configuring a workspace bot, this skill provides a unified interface to query, create, update, and delete calendar entries.
By integrating with popular calendar hosts—including Google Calendar, iCloud, Nextcloud, Fastmail, and NetEase—this tool ensures high compatibility. It is architected for developers who need to empower their terminal scripts or autonomous agents with real-time scheduling capabilities, free/busy queries, and cross-platform productivity workflows. As with other Openclaw Skills, security and efficiency are core design choices, incorporating secure credential caching and robust multi-account management.
CalDAV Sync Tool Use Cases
- Automated event scheduling: Configure AI agents using Openclaw Skills to book, reschedule, or cancel calendar events dynamically based on email or chat prompts.
- Multi-account task synchronization: Aggregate personal and work task lists (todos) across different platforms like Google and iCloud from a single CLI command.
- Free/busy slot discovery: Query block times for team members or personal accounts to find ideal meeting times automatically.
- Local calendar caching: Store and perform ultra-fast lookups on upcoming events by utilizing incremental synchronization features.
How CalDAV Sync Tool Works
- Initialization & Configuration: The system reads account credentials, providers, and default calendar identifiers from a central secure configuration file (
~/.config/mail-skills/.env). - Provider Resolution: Based on the
PROVIDERpreset (such as Gmail, iCloud, or custom), the tool automatically determines the server endpoint and authorization mechanisms. - Sync Strategy Execution: When querying events, the skill attempts an incremental sync using a sync-token or CTAG/ETAG headers to optimize resource usage and reduce API requests.
- Caching & DB Operations: Synchronization states and event details are locally cached. Write actions immediately invalidate relevant caches to prevent stale data.
- Command Line Dispatch: Executes operations (like creating a todo or fetching an event) via Node.js scripts which interface directly with the remote CalDAV API.
CalDAV Sync Tool Setup
To add this package to your suite of Openclaw Skills, run the setup script to install dependencies and configure your CalDAV account:
bash setup.sh
If executing commands manually without the automated setup, install the production dependencies first:
npm install --production
Config File Format
The configuration is stored at ~/.config/mail-skills/.env (shared with the imap-smtp-email skill). If no shared config is found, the skill falls back to a .env file in the skill directory.
# Default account
PROVIDER=163
[email protected]
PASSWORD=your_password
CALDAV_DEFAULT_CALENDAR=
For custom CalDAV servers, specify the custom provider and server URL:
PROVIDER=custom
[email protected]
PASSWORD=your_password
CALDAV_SERVER_URL=https://your-caldav-server.com/
CalDAV Sync Tool Data Schema & Taxonomy
This skill manages cache directories and credentials in a secure manner:
| Component | Path / Detail | Description |
|---|---|---|
| Config File | ~/.config/mail-skills/.env |
Stores provider configuration and login credentials with 600 permissions. |
| Sync Cache | ~/.config/mail-skills/caldav-cache/ |
Stores synchronization states, sync tokens, and CTAGs per account and calendar. |
Incremental Sync Strategy
The tool leverages a multi-tiered sync strategy:
- sync-token: Fetches only modified resources (preferred standard method).
- ctag + etag: Compares calendar and resource tags to fetch changed resources if sync tokens are unsupported.
- full: Fallback method that fetches all calendar and todo resources.
CalDAV Sync Tool Advanced Features
- Multi-account support: Configure separate prefixed variables (e.g.,
WORK_PROVIDER,WORK_USERNAME) to query distinct CalDAV databases on the fly using--account <name>. - Advanced Incremental Sync: Built-in local caching mechanism prevents unnecessary network requests and rate limits by fetching only updated entries.
- Cache invalidation: Automated cache invalidation whenever a local script performs a write, update, or deletion operation.
- Free/Busy validation: Instant query of availability time blocks for scheduling optimization via Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Seedance Video Prompt Industrial Generator
An industrial-grade workflow engine that converts scripts and stories into fully optimized, scene-by-scene video prompts for Seedance 2.0.
Pet Treadmill Intensity and Heart Rate Analysis
An AI-powered pet fitness skill that analyzes treadmill video gait patterns and optional heart rate telemetries to assess exercise intensity and safety thresholds.
Code Formatter
An automated code formatting skill that cleans and standardizes raw code snippets across multiple languages using industry-standard style guides.
Repo Scout
A powerful repository analysis and trend tracking skill designed to convert raw GitHub data into structured research, project ideas, and actionable reports.
Mood Journal
A personal AI-driven emotional tracking and analysis tool that identifies long-term psychological trends, triggers, and effective coping strategies.
Agent Wallet Skill
A secure USDC blockchain wallet skill for AI agents on the Base network, supporting the x402 payment protocol and zero-dependency read-only balance checks.
Featured*
