gog is a command-line client for Google Workspace services such as Gmail, Calendar, Drive, Docs, and Sheets. It is used by people, scripts, continuous-integration jobs, and coding agents that need account selection, structured output, and permission controls from a terminal.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/openclaw/gogcli/gog-chat-messages-listgit clone --depth 1 https://github.com/openclaw/gogcliWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/openclaw/gogcli/gog-chat-messages-list)<a href="https://agentmods.dev/commands/openclaw/gogcli/gog-chat-messages-list"><img src="https://agentmods.dev/badge/commands/openclaw/gogcli/gog-chat-messages-list.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.01021 |
| Opus 5 | $0.00000 | $0.00511 |
| Sonnet 5 | $0.00000 | $0.00204 |
| Haiku 4.5 | $0.00000 | $0.00102 |
Grade A, and why
gog-chat-messages-list scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
78% identical to gog-admin-groups-list — 16 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 55 lines — stays where its author put it; the contents beside it link to each section on GitHub.
gog chat messages list
Generated from
gog schema --json. Do not edit this page by hand; runmake docs-commands.
List messages
Usage
gog chat messages list (ls) <space> [flags]
Parent
Flags
| Flag | Type | Default | Help |
|---|---|---|---|
--access-token |
string |
Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h) | |
-a--account--acct |
string |
Account email, alias, or auto for authenticated Google API commands | |
--all--all-pages--allpages |
bool |
Fetch all pages | |
--client |
string |
OAuth client name (selects stored credentials + token bucket) | |
--color |
string |
auto | Color output: auto|always|never |
--disable-commands |
string |
Comma-separated list of disabled commands; dot paths allowed | |
-n--dry-run--dryrun--noop--preview |
bool |
Do not make changes; print intended actions and exit successfully | |
--enable-commands |
string |
Comma-separated list of enabled command prefixes; dot paths allowed (restricts CLI) | |
--enable-commands-exact |
string |
Comma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children | |
--fail-empty--non-empty--require-results |
bool |
Exit with code 3 if no results | |
-y--force--assume-yes--yes |
bool |
Skip confirmations for destructive commands | |
--gmail-no-send |
bool |
false | Block Gmail send operations (agent safety) |
-h--help |
kong.helpFlag |
Show context-sensitive help. | |
--home |
string |
Override gogcli config/data/state/cache root (equivalent to GOG_HOME) | |
-j--json--machine |
bool |
false | Output JSON to stdout (best for scripting) |
--max--limit |
int64 |
50 | Max results |
--no-input--non-interactive--noninteractive |
bool |
Never prompt; fail instead (useful for CI) | |
--order |
string |
Order by (e.g. createTime desc) | |
--page--cursor |
string |
Page token | |
-p--plain--tsv |
bool |
false | Output stable, parseable text to stdout (TSV; no colors) |
--quota-project |
string |
Google Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC) | |
--readonly |
bool |
false | Block mutating API requests at runtime; auth add also requests read-only OAuth scopes |
--results-only |
bool |
In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) | |
--select--pick--project |
string |
In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. | |
--thread |
string |
Filter by thread (spaces/.../threads/...) | |
--unread |
bool |
Only messages after last read time | |
-v--verbose |
bool |
Enable verbose logging | |
--version |
kong.VersionFlag |
Print version and exit | |
--wrap-untrusted |
bool |
false | In JSON/raw output, wrap fetched text fields in external untrusted-content markers |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +1 lines 31bf721d4705
- 3d ago First seen · 54 lines · 0 tokens per session scan A b1b7a7442e69
gog-chat-messages-list is a command published in the GitHub repository openclaw/gogcli (8,368 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,021 tokens. A static security scan graded it A with 0 findings. It is 78% identical to gog-admin-groups-list, differing in 16 lines, and is treated as a copy.
Other commands, from other repositories
setup-gogcli.es
Command "setup-gogcli.es" from minicoohei/ai-agent-camp, covering configuración de gogcli (google workspace cli), step 0: verificar el progreso de configuración, lo que hará en esta sesión, verificación de preparación and step 1: instalar gogcli.
setup-gogcli
Command "setup-gogcli" from minicoohei/ai-agent-camp, covering gogcli (google workspace cli) セットアップ, step 0: セットアップ進捗の確認, このセッションでやること, 準備チェック and step 1: gogcli のインストール.
setup-gogcli.en
Command "setup-gogcli.en" from minicoohei/ai-agent-camp, covering gogcli (google workspace cli) setup, step 0: check setup progress, what you'll do in this session, readiness check and step 1: install gogcli.
checkemail
Quick inbox cleanup — archive junk, then triage what matters one at a time.
Manage email across Gmail accounts via gmail MCP.
ler-drive
Lê e cria recursos do Google Drive (planilhas, pastas, documentos) via MCP.