gog-contacts

name	gog-contacts
description	Google Contacts operations through gog.

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 [e-mail] contacts search alice --json --wrap-untrusted

• Select the account explicitly with --account.
• Use --json --wrap-untrusted for agent-readable Google content.
• Use --readonly when the task must not mutate Google data.
• Use --no-input in automation and --dry-run before 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.