---
name: gog-photos
description: "Google Photos via the gog CLI (Photos Library API, app-created media): list, search, get, and download media items. Use for Photos automation with JSON output. Scope is limited to app-created media."
---

# gog photos

Photos Library reads with parseable output. Pick the account on every call with
`--account <email>` (or set `GOG_ACCOUNT`). Requires the Photos Library API
enabled; the API only exposes **app-created** media, not the full library.

## Reads

```bash
gog --account you@example.com photos list --max 20 --json --wrap-untrusted
gog --account you@example.com photos search --query "..." --json --wrap-untrusted
gog --account you@example.com photos get <mediaItemId> --json --wrap-untrusted
gog --account you@example.com photos download <mediaItemId> -o ./photo.jpg
```

## Safety

- Read/download surface — no destructive mutations here. Pass `--no-input` in automation.
- stdout is data (`--json`/`--plain`); hints go to stderr.

## Discovery

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