setup-google-contacts

A private, single-user tool that keeps the operator's own contact labels tidy and builds a small address book for the operator's own assistant.

setup-google-contacts does two things with the operator's own Google Contacts. It takes a complete local backup of them, and it maintains the account's contact groups — the labels — declaratively: the groups that should exist are listed in a text file kept under version control, the tool shows the difference against the live account, and applies it only on an explicit confirmation.

Separately, it renders a short address book — names, nicknames and email addresses for a hand-picked handful of people — so that the operator can tell their own assistant “write to Kate” and have it resolve to the right address. Who appears in that list is decided by hand in a configuration file, not by any rule applied to the account.

It is not a product and has no users other than its author. There is no sign-up, no hosted service and nobody else's account is ever touched. This page exists because Google requires an application using the People API to publish a home page and a privacy policy.

What it does

1. Reads the contacts, contact groups and — on a Google Workspace account — the organisation's own directory profiles, and writes them to a backup file on the operator's machine.
2. Compares the contact groups on the account with the list in the configuration file and shows the difference.
3. On an explicit confirmation, creates or deletes contact groups so that the account matches the file. Deleting a group never deletes the contacts in it; the application does not create, modify or delete a single contact.
4. Renders the hand-picked address book as a text file for the operator's own use.

Everything runs on the operator's own machines, started by hand or by a timer they configured. It is not a web service and accepts no inbound connections. Its source lives in a private repository.