---
name: gog-contacts
description: "Google Contacts via the gog CLI: list/search/get contacts, export, search the domain directory and 'other contacts', create/update/delete, and dedupe. Use for contact automation and read-only contact audits with JSON output."
---

# gog contacts

Contacts reads and writes with parseable output. Pick the account on every call
with `--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@example.com contacts list --max 20 --json --wrap-untrusted
gog --account you@example.com contacts search "acme" --json --wrap-untrusted
gog --account you@example.com contacts get <resourceName> --json --wrap-untrusted
gog --account you@example.com contacts export --json
gog --account you@example.com contacts directory search "jane" --json --wrap-untrusted
gog --account you@example.com contacts other list --json --wrap-untrusted
```

## Writes

```bash
gog --account you@example.com contacts create --name "Jane Doe" --email jane@acme.com
gog --account you@example.com contacts update <resourceName> --email new@acme.com
gog --account you@example.com contacts delete <resourceName> --force
gog --account you@example.com contacts dedupe --dry-run
```

## Safety

- `delete` and `dedupe` are destructive — `--dry-run` first, then `--force` only
  for the exact change requested. `dedupe` can merge/remove many contacts.
- `directory`/`other`/`export` reads are non-mutating; safe for audits.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--no-input` in automation.

## Discovery

`gog contacts --help` · `gog contacts <cmd> --help` · `gog schema contacts <cmd> --json`
Reference: <https://gogcli.sh/>
