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 datathat 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 tableon 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.

Three paths to connect

Today every path lands at the same place: a .vcffile (the universal vCard format). Native Google, Outlook, and Apple integrations are on the way in v1.1 — until then, exporting a .vcf from each service is the one-minute workaround that works everywhere.

Option A: Import a .vcf file (works for everyone)

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

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

Option B: Google Contacts (coming in v1.1)

Planned for v1.1. Once shipped, it will use OAuth similar to Google Calendar — click Connect, grant the read-only contacts.readonly scope, done. For now, export to .vcf and use Option A.

Option C: Outlook Contacts (coming in v1.1)

Planned for v1.1. Will reuse the existing Microsoft sign-in Vrge already uses for Outlook mail — no second login. For now, export to .vcf and use Option A.

Option D: Apple Contacts (coming in v1.1)

Planned for v1.1 on the Mac desktop build — Vrge will read the local address book natively (no cloud round-trip). For now, export from the Contacts app on your Mac: File → Export → Export vCard…. Then use Option A.

How to export a .vcf from each app

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

Google Contacts

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

Apple Contacts (Mac)

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

Outlook.com / Microsoft 365

  1. 1.Switch to the People view.
  2. 2.In the top-right toolbar, click Manage contacts.
  3. 3.Click Export contacts.
  4. 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. 1.On your iPhone, open Settings → iCloud and make sure Contacts sync is turned on.
  2. 2.On a computer, go to icloud.com and open Contacts.
  3. 3.Click the Settings gear in the bottom-left.
  4. 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 .vcfand 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.