A comprehensive command-line interface for managing multiple CalDAV calendar accounts with secure OS keychain integration and JSON output support.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install caldav-cli
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-cli 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 CLI?
CalDAV CLI is a specialized tool built for developers and power users who need to interact with calendar services like Apple iCloud, Google Calendar, and Yandex directly from the terminal. By integrating this tool into your workflow, you leverage the power of Openclaw Skills to maintain a unified view of your schedule across different providers. It emphasizes security by using the native OS keychain for sensitive credentials and offers both interactive wizards and non-interactive flag-based commands for maximum flexibility.
The tool is particularly useful for those who prefer CLI-driven productivity or need to automate calendar interactions through scripts. Its ability to output data in JSON format makes it a perfect fit for building custom integrations or dashboards that require real-time calendar data access without the overhead of a heavy GUI application.
CalDAV CLI Use Cases
- View upcoming meetings and events across multiple provider accounts in a single terminal view.
- Create calendar events quickly using interactive prompts or one-liner shell commands.
- Automate schedule reporting by piping JSON event data into other developer tools.
- Manage calendar accounts securely on shared workstations using OS-level keychain storage.
- Integrate calendar management into automated CI/CD or notification workflows.
How CalDAV CLI Works
- The user installs the package globally to gain access to the caldav-cli command.
- The account add command initiates an interactive wizard to configure providers like Google (OAuth2) or iCloud (Basic auth).
- Sensitive data, including OAuth2 refresh tokens and app-specific passwords, are stored securely in the macOS Keychain, Linux libsecret, or Windows Credential Vault.
- When fetching events, the tool queries the CalDAV server and parses the iCalendar data into a structured format.
- Users can filter results by date range, account, or specific calendar name, receiving either a formatted table or raw JSON output.
CalDAV CLI Setup
Install the tool globally using Node.js:
npm install -g caldav-cli
Initialize your first calendar account:
caldav-cli account add
Follow the interactive prompts to select your provider and authenticate. For Google Calendar users, you will need an OAuth Client ID and Secret from the Google Cloud Console.
CalDAV CLI Data Schema & Taxonomy
The skill manages data across two primary layers to balance security and accessibility:
| Component | Storage Type | Details |
|---|---|---|
| Secrets | OS Keychain | OAuth2 tokens, passwords, and client secrets are encrypted via @napi-rs/keyring. |
| Configuration | Local JSON File | Account metadata (names, URLs) is stored in ~/.config/caldav-cli/config.json with 0600 permissions. |
| Output | JSON/Table | Command results are rendered as CLI tables or structured JSON objects for scripting. |
CalDAV CLI Advanced Features
- Secure migration logic that automatically moves plaintext credentials from config files to the OS keychain on first run.
- Headless OAuth2 flow support for Google Calendar, making it ideal for remote server environments.
- Granular filtering options for event listing, including specific date ranges and calendar-specific queries.
- Full support for custom CalDAV server URLs, enabling compatibility with self-hosted solutions like Nextcloud or Baikal.
- Script-friendly JSON output mode for seamless integration with other Openclaw Skills and automation pipelines.
SKILL.md
Loading
Related Openclaw Skills
Sparkle VPN Control
A streamlined toolset for controlling Sparkle VPN and Mihomo core directly from the command line without GUI interaction.
Dev Workflow
A unified automation orchestrator that manages the end-to-end development lifecycle from initial setup to final version sealing.
Development Task & Versioning Manager
A standardized development task management skill that enforces strict semantic versioning and mandatory project archiving to prevent code loss.
Dev Pipeline
A comprehensive versioned development pipeline that orchestrates AI agents through analysis, coding, review, and deployment stages.
claude-cost-cli
A secure macOS command-line tool for auditing Anthropic Admin API usage and token costs with Keychain integration.
Claude Usage CLI
A command-line interface for monitoring Anthropic Admin API usage and spend directly from your terminal.
METADATA
Featured*
