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.
Borrowing it
Nothing to install: this file belongs to openclaw/gogcli. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/openclaw/gogcli/main/.agents/skills/gog-gmail/SKILL.mdgit 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/skills/openclaw/gogcli/gog-gmail)<a href="https://agentmods.dev/skills/openclaw/gogcli/gog-gmail"><img src="https://agentmods.dev/badge/skills/openclaw/gogcli/gog-gmail/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/openclaw/gogcli/gog-gmail"><img src="https://agentmods.dev/badge/skills/openclaw/gogcli/gog-gmail.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00011 | $0.00541 |
| Opus 5.5 | $0.00004 | $0.00216 |
| Sonnet 5.5 | $0.00002 | $0.00108 |
| Haiku 4.5 | $0.00001 | $0.00054 |
Grade A, and why
gog-gmail 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 1mo ago.
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.
How it starts
The opening of the file, as written. The whole thing — 57 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Gmail
Use gog for Gmail operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema gmail --json
gog --readonly --account [email protected] gmail search 'newer_than:7d' --max 10 --json --wrap-untrusted
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
archive |
Archive messages or explicit threads (remove from inbox) |
attachment |
Download a single attachment |
autoreply |
Reply once to matching messages |
batch |
Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) |
drafts |
Draft operations |
forward |
Forward a message to new recipients |
get |
Get a message (full|metadata|raw) |
history |
Gmail history |
import |
Import an RFC822/EML message into Gmail |
labels |
Label operations |
mark-read |
Mark messages as read |
messages |
Message operations |
raw |
Dump raw Gmail API response as JSON (Users.Messages.Get; lossless; for scripting and LLM consumption) |
reply |
Reply to a message |
reply-all |
Reply to all message participants |
search |
Search threads using Gmail query syntax |
send |
Send an email |
settings |
Settings and admin |
thread |
Thread operations (get, modify) |
track |
Email open tracking |
trash |
Move messages to trash |
unread |
Mark messages as unread |
url |
Print Gmail web URLs for threads |
Run gog gmail <command> --help for flags and gog schema gmail <command> --json
for the machine-readable contract. Do not guess command syntax.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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.
- 1mo ago First seen · 57 lines · 11 tokens per session scan A a71117666394
gog-gmail is a skill published in the GitHub repository openclaw/gogcli (8,542 stars, last pushed 2d ago), licensed MIT. It adds 11 tokens to every session and 541 once invoked, about $0.0000 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
gmail
Send, read, and manage Gmail messages and email attachments automatically.
gog
Operate Google Workspace from the terminal via the gog CLI (gogcli). Use for checking and replying to Gmail, managing Google Tasks, reading and creating Calendar events, Google Chat (spaces/DMs/messages), Meet spaces, Contacts, Drive/Docs/Sheets, and more. Triggers on /gog, /gog mail, /gog tasks, /gog events, /gog…
triage
Work a Gmail inbox with mailwarden — search, bulk actions, snooze, unsubscribe and recurring checks, with the rules that keep a bulk action from touching mail the user never meant to touch. Use when the user asks to triage, clean up, archive, label, snooze or unsubscribe from mail through mailwarden, before any…
google-workspace
Google Workspace integration - Gmail, Calendar, Drive operations via Google APIs.
managing-google-workspace
Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search). Supports MCP tools or the workspace-cli client. Provides tool routing, workflows, and parameter guidance for every tool. Triggers for "check my email", "find…
gmail-tool
Gmail integration tool. Performs unread check, body retrieval, and draft creation via Gmail API using OAuth2. Use when: Use when: you need to check received emails, read email bodies, create drafts, search the inbox, or work with labeled emails.