Skip to content
Vrge

Connecting Contacts (Your Address Book)

Vrge watches your email, calendar, files, and banking for signs of client activity. Your address book isn't a source of proposals on its own. It's seed data that makes every other source smarter. When Vrge sees an inbound email from someone already in your contacts, it knows not to flag that person as a brand new client. Without contacts, the observer has to guess who you know and who you don't — and guessing is how Mom ends up in your proposal inbox as a prospective lead.

What Vrge does with your contacts

Contacts live in a local-only table on your device. They are never sent to any cloud AI provider: not Anthropic, not OpenAI, not Google, not Vrge Managed AI. They are matcher input, not prompt input. The main mechanical behavior: suppressing a personal contact (like Mom, a friend, or your dentist) from being proposed as a new client the next time they send you an email.

How to connect

Contacts come in as a .vcf file, the universal vCard format that every address book exports. Google, Outlook, Apple Contacts and your phone all produce one, so this single path works no matter where your contacts live.

Import a .vcf file

Universal format. No login, no OAuth. If your contacts live anywhere at all, you can get them out as a .vcf file.

  1. Open Vrge.
  2. Go to Settings → Sources.
  3. Scroll to the Contacts section.
  4. Click Import .vcf.
  5. Either upload the .vcf file you exported, or paste raw vCard content into the text box.
  6. Hit Import. Vrge parses it locally and you're done.

How to export a .vcf from each app

Step-by-step for the four places most people keep their contacts.

Google Contacts

  1. Go to contacts.google.com.
  2. Click the Export button on the left nav.
  3. Pick vCard (for iOS Contacts).
  4. Click Export. The file downloads as contacts.vcf.

Apple Contacts (Mac)

  1. Open the Contacts app.
  2. Press Cmd+A to select all contacts.
  3. In the menu bar, click File → Export.
  4. Choose Export vCard… and save the file wherever you like.

Outlook.com / Microsoft 365

  1. Switch to the People view.
  2. In the top-right toolbar, click Manage contacts.
  3. Click Export contacts.
  4. Choose vCard as the format and save.

iPhone

iOS doesn't have a direct export UI on the phone itself. The trick is to go through iCloud in a browser.

  1. On your iPhone, open Settings → iCloud and make sure Contacts sync is turned on.
  2. On a computer, go to icloud.com and open Contacts.
  3. Click the Settings gear in the bottom-left.
  4. Choose Export vCard… and save.

What happens after import

Vrge parses the .vcf locally and populates the known_contacts table on your device. The next observer run (triggered automatically right after import) uses that data. You'll see fewer false new client proposals in the inbox almost immediately.

Re-importing and multiple address books

If your contacts change, export a fresh .vcf and import it again. Duplicates are deduplicated automatically by contact ID, so nothing gets doubled up. You can also import multiple files (for example, personal and work) and give each one a label so they're distinguishable in the Sources list.

Privacy

  • Contacts never ship to cloud AI. They are matcher input, not prompt input. They stay on your device even if every other source is running in full-content cloud mode.
  • Disconnect any time. Go to Settings → Sources, find the Contacts entry, and click Disconnect. Vrge wipes the imported contacts from the local table immediately.
  • No network calls during sync. The .vcf parse and database write happen entirely on your machine. Nothing leaves your computer.