carddav-contacts
by jcromero
DevOps & CloudBrief
Sync and manage CardDAV contacts (Google, iCloud, Nextcloud, etc.) using vdirsyncer + khard.
Description
What This Skill Does
Syncs CardDAV contacts from Google, iCloud, Nextcloud, and similar providers to local .vcf files using vdirsyncer, then manages them via khard's CLI interface.
Keeps contacts locally accessible and scriptable without requiring a GUI or browser, making them composable with other CLI tools.
When to Use It
- Look up a contact's phone number from the terminal
- Search contacts by name across multiple address books
- Edit or create contacts in a text-based editor
- Move contacts between address books (personal, work)
- Extract emails or phone numbers for use in scripts
Example Workflow
User asks: find John's email address
- 1
Run vdirsyncer sync to pull latest contacts from the remote CardDAV server
- 2
Run khard email "john" to extract email addresses for matching contacts
- 3
Parse the tab-separated output to identify the correct entry
john.doe@example.com
Requirements
- Google App Password (if using Google Contacts with 2FA enabled)
- CardDAV account credentials (Google, iCloud, Nextcloud, or other provider)
Installation
clawhub install jcromero/carddav-contactsRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.