Open source CLI tool for Google Contacts

Your contacts are a mess.
Let AI fix them.

Contact Refiner automatically fixes diacritics, formatting, and duplicates in your Google Contacts. 23 rule categories + Claude AI review. You approve every change.

terminal
$ pip install google-contacts-refiner
$ contacts-refiner analyze
Found 2,847 contacts
847 changes detected (23 rule categories)
412 HIGH confidence → auto-fixed
435 MEDIUM → queued for AI review
$ contacts-refiner fix --auto
Applied 412 changes in 23s
# Review remaining changes at
# https://contactrefiner.com/dashboard

What it fixes

Rule-based analysis catches the obvious. AI handles the rest.

Diacritics Restoration

Fixes Štefan → Stefan, Kříž → Kriz and 899+ SK/CZ/HU name patterns automatically.

Smart Formatting

Normalizes phone numbers, titles, company names, and name casing across all contacts.

AI Review

Claude AI catches edge cases that rules miss. You approve every change before it applies.

Interaction Tracking

Scans Gmail and Calendar to tag contacts with activity year labels (Y2024, Y2025).

LTNS Reconnect

Identifies contacts you haven't talked to in over a year and generates reconnect prompts.

Privacy First

Runs on your own infrastructure. Your contacts never leave your Google account.

How it works

Three steps. You stay in control.

01

Authenticate

Connect your Google account with OAuth2. Read-only access to Contacts, Gmail, and Calendar.

02

Analyze

The pipeline scans all contacts with 23 rule categories, then AI reviews ambiguous cases.

03

Review & Fix

Review changes on the dashboard. Approve, reject, or edit. Only approved changes are applied.

Clean up your contacts today

Open source. Self-hosted. Your data stays yours.

Get started on GitHub