A command-line powerhouse for synchronizing and managing CardDAV contacts locally using vdirsyncer and khard.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install carddav-contacts
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 carddav-contacts 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 CardDAV Contacts?
The CardDAV Contacts skill enables developers to bridge the gap between cloud-based contact services and the local terminal. By utilizing vdirsyncer for two-way synchronization and khard for a robust CLI interface, users can interact with their address books from Google, iCloud, or Nextcloud without a web browser. This integration within Openclaw Skills provides a streamlined workflow for developers who prefer managing their digital life through text-based tools and local files.
CardDAV Contacts Use Cases
- Synchronizing contacts across multiple cloud providers like Google and Nextcloud into a unified local environment.
- Performing rapid searches for contact details directly from the command line.
- Automating contact data extraction for use in shell scripts or terminal-based communication tools.
- Maintaining an offline-first address book that supports bidirectional syncing.
How CardDAV Contacts Works
- vdirsyncer connects to remote CardDAV servers to fetch and push contact data.
- Remote contacts are stored as local .vcf files in a specified directory.
- khard indexes these files to provide a searchable and editable interface.
- Users execute khard commands to view, edit, or create contacts locally.
- Running a sync command pushes local modifications back to the cloud provider.
CardDAV Contacts Setup
First, install the necessary dependencies on Linux:
sudo apt install vdirsyncer khard
Create the local storage directory:
mkdir -p ~/.local/share/vdirsyncer/contacts
Configure ~/.config/vdirsyncer/config with your remote storage details and run the discovery command:
vdirsyncer discover google_contacts
vdirsyncer sync
Finally, ensure ~/.config/khard/khard.conf points to your local vdirsyncer path to enable CLI management.
CardDAV Contacts Data Schema & Taxonomy
The skill organizes data using standard formats and filesystem paths:
| Component | Path | Description |
|---|---|---|
| Contact Files | ~/.local/share/vdirsyncer/contacts/ |
Directory containing individual .vcf files. |
| Sync Config | ~/.config/vdirsyncer/config |
Configuration for remote CardDAV endpoints and local storage. |
| CLI Config | ~/.config/khard/khard.conf |
Settings for display, sorting, and default search actions. |
| Metadata | .vcf headers | Stores contact fields like UID, FN, TEL, and EMAIL. |
CardDAV Contacts Advanced Features
- Smart Search: Configure default_action as list to allow direct name searching without subcommands.
- YAML Integration: View or export contact details in YAML format for easier programmatic processing.
- Scriptable Output: Use the -p flag to generate tab-separated parsable output for automation pipelines.
- Multi-Book Management: Seamlessly move contacts between different address books (e.g., from Work to Personal) via CLI.
SKILL.md
Loading
Related Openclaw Skills
Ship My Token
A no-code AI agent skill for launching and managing Solana tokens on Pump.fun through natural conversation.
OpenSpec
A powerful CLI tool for managing spec-driven development workflows that structures AI-assisted coding into trackable, artifact-led changes.
Work Receipt
Transform messy coding sessions into structured, professional receipts that detail your accomplishments, decisions, and technical debt.
Time Capsule
Time Capsule lets you bury messages in your codebase that surface automatically when specific conditions like file modifications or code metrics are triggered.
PersonaNexus Board of Directors Skill
A sophisticated framework for integrating a virtual advisory board of historical figures into AI agent identities through structured YAML configurations.
PersonaNexus Religion Skill
An advanced skill for defining and integrating spiritual, religious, and ethical frameworks into AI agent identities using structured YAML configuration.
Featured*
