Agent skill · marketing growth · steipete
gog
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Why this skill is useful
Provides specific commands and workflows for managing Google Workspace services that the AI wouldn't reliably generate on its own.
What it needs
Requires gog installed locally. Requires google account access. About 4k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
gog Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup. Prefer an already-authorized host account: run the requested gog command first. Enter setup only after an authentication error. Never ask for passwords, client secrets, or refresh tokens in chat. Setup (once) gog auth credentials /path/to/clientsecret.json gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets gog auth list Remote / headless Gateway hosts When the Gateway host has no local browser display: 1. Prefer a live callback listener on the Gateway host. From the machine with the browser, forward the exact callback port (ssh -L <port>:127.0.0.1:<port> user@gateway-host), open the authorization URL gog prints, and let the redirect complete on that forwarded port. 2. When a live listener is unavailable, the operator picks one paste-mode path in a trusted shell on the Gateway host. Callback URLs must never enter chat or agent tool input: --manual: the operator pastes the full redirect URL into gog's interactive prompt. --remote --step 1: prints authurl (and statereused) then exits. After browser consent, the operator runs --remote --step 2 --auth-url <callback-url> in the trusted shell. A failed localhost page load after consent is expected. 3. Keep the same resolved config context across remote steps: GOGCONFIGDIR takes precedence over --home, which takes precedence over GOGHOME. Also preserve --client, services/scopes, redirect URI, and consent options. Matching unexpired manual state may be reused (statereused=true). 4. If desktop keyring is unavailable, configure the file backend (gog auth keyring file) and set GOGKEYRINGPASSWORD in the Gateway environment so non-interactive agent/--no-input runs can read tokens. gog auth doctor reports when the password is missing. 5. Callback received is not the same as token stored. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/gog