Google Contacts
Use gog for Google Contacts operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema contacts --json
gog --readonly --account user@example.com contacts search alice --json --wrap-untrusted
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
create |
Create a contact |
dedupe |
Find likely duplicate contacts and optionally merge them |
delete |
Delete a contact |
directory |
Directory contacts |
export |
Export contacts as vCard (.vcf) |
get |
Get a contact |
list |
List contacts |
other |
Other contacts |
raw |
Dump raw People API response as JSON (People.Get; lossless; for scripting and LLM consumption) |
search |
Search contacts by name/email/phone |
update |
Update a contact |
Run gog contacts <command> --help for flags and gog schema contacts <command> --json
for the machine-readable contract. Do not guess command syntax.