carddav-contacts

What This Skill Does

The carddav-contacts skill provides a robust command-line interface for managing address books by integrating vdirsyncer and khard. It bridges the gap between remote cloud-based contact providers—such as Google Contacts, iCloud, and Nextcloud—and your local file system. By using vdirsyncer to perform bidirectional synchronization of .vcf files and khard to provide a feature-rich CLI, the agent allows you to search, view, edit, and create contacts directly from your terminal. It essentially turns your remote contact ecosystem into a searchable, editable local database.

Installation

To integrate this skill into your OpenClaw agent, execute the installation command: clawhub install openclaw/skills/skills/jcromero/carddav-contacts. After installation, you must configure the backing services. First, set up your sync parameters in ~/.config/vdirsyncer/config to point to your CardDAV server. Next, configure ~/.config/khard/khard.conf to map the local path where vdirsyncer stores your contacts. Finally, run vdirsyncer discover and vdirsyncer sync to bootstrap your database. Ensure your environment variables and file permissions allow the agent to access these configuration directories.

Use Cases

This skill is perfect for users who prefer working in a terminal-centric environment. Use it to quickly lookup phone numbers or email addresses during a workflow without switching to a web browser or GUI contacts app. It is also ideal for bulk-managing contacts, moving entries between different address books (e.g., separating Work and Personal), and integrating contact data into automation scripts via pipeable output. Since it relies on local vCard files, it provides a performant way to manage large address books with near-instant search results.

Example Prompts

1. "Sync my contacts and find the email address for John Doe."
2. "Show me all phone numbers associated with Pilar in my work address book."
3. "Create a new contact named Jane Smith and set her phone number to 555-0123."

Tips & Limitations

Always remember to execute vdirsyncer sync before running queries to ensure data consistency with the server. If you perform edits offline, the changes will not be pushed to your cloud provider until the next sync. Be aware that the skill relies on the presence of local configuration files; if these are deleted, the agent will lose its link to your contacts. For best results, ensure your khard configuration includes default_action = list to enable the most efficient search experience.