Contacts Setup

Connect your address book to Chalie via CardDAV.

Connecting your address book

Chalie syncs contacts over CardDAV — the same open protocol your phone and desktop use to sync contacts.

Step by step

  1. Open the Brain panel (the ⚙️ icon in the sidebar)
  2. Switch to the Capabilities tab
  3. Find Contacts and toggle it on
  4. Enter your CardDAV connection details:
    • Server URL — your provider’s CardDAV endpoint
    • Username — typically your email address
    • Password — your account password or app-specific password
  5. Click Test Connection to verify the sync works

Common provider URLs

Provider CardDAV URL
Google Contacts https://www.googleapis.com/carddav/v1/principals/
iCloud https://contacts.icloud.com/
Fastmail https://carddav.fastmail.com/dav/addressbooks/
Nextcloud https://your-server.com/remote.php/dav/
Radicale https://your-server.com/

Google Contacts users

Like other Google services, CardDAV access requires an App Password:

  1. Go to myaccount.google.com
  2. Navigate to Security → 2-Step Verification → App passwords
  3. Create a new app password for “Contacts”
  4. Use the generated password in Chalie’s contacts settings

Troubleshooting

  • No contacts found — verify the CardDAV URL points to your address book collection
  • Authentication failed — check your credentials; Google/iCloud users need App Passwords
  • Partial sync — some providers limit the number of contacts returned per request; large address books may take a moment to fully index