---
name: gog-keep
description: "Google Keep via the gog CLI (Workspace only): list/search/get notes, read attachments, and create/delete notes. Requires a configured service account. Use for Keep note automation with JSON output."
---

# gog keep

Keep note operations with parseable output. **Workspace-only** and requires a
configured service account (`gog auth keep --help`). Pick the account with
`--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@domain.com keep list --json --wrap-untrusted
gog --account you@domain.com keep search "groceries" --json --wrap-untrusted
gog --account you@domain.com keep get <noteId> --json --wrap-untrusted
gog --account you@domain.com keep attachment <noteId> <attachmentId> -o file
```

## Writes

```bash
gog --account you@domain.com keep create --title "Temp - note" --text "..."
gog --account you@domain.com keep delete <noteId> --force
```

## Safety

- `delete` removes the note and needs `--force` — confirm the note id.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--no-input` in automation.

## Discovery

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