---
name: gog-people
description: "Google People via the gog CLI (read-only): look up your own profile, fetch a person, search profiles, and read relations. Use to resolve identities and profile details with JSON output."
---

# gog people

Read-only People API lookups with parseable output. Pick the account on every
call with `--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@example.com people me --json --wrap-untrusted
gog --account you@example.com people get <resourceName> --json --wrap-untrusted
gog --account you@example.com people search "jane" --json --wrap-untrusted
gog --account you@example.com people relations --json --wrap-untrusted
```

`gog whoami` / `gog me` are aliases for `people me`.

## Safety

- Read-only surface — no mutations. Still pass `--no-input` in automation.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--wrap-untrusted`
  when feeding fetched profile text to an agent.

## Discovery

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