Google Workspace CLI (gog)

---

name: gog description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. homepage: https://gogcli.sh tags: ["google", "gmail", "calendar", "drive", "sheets", "docs", "productivity", "workspace"] metadata: {"clawdbot":{"emoji":"🎮","requires":{"bins":["gog"],"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}}}

---

gog

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.

Setup (once)

gog auth credentials /path/to/client_secret.json

gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs

gog auth list

Common commands

Gmail search: gog gmail search 'newer_than:7d' --max 10

Gmail send: gog gmail send --to a@b.com --subject "Hi" --body "Hello"

Calendar: gog calendar events --from --to

Drive search: gog drive search "query" --max 10

Contacts: gog contacts list --max 20

Sheets get: gog sheets get "Tab!A1:D10" --json

Sheets update: gog sheets update "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED

Sheets append: gog sheets append "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS

Sheets clear: gog sheets clear "Tab!A2:Z"

Sheets metadata: gog sheets metadata --json

Docs export: gog docs export --format txt --out /tmp/doc.txt

Docs cat: gog docs cat

Notes

Set GOG_ACCOUNT=you@gmail.com to avoid repeating --account.

For scripting, prefer --json plus --no-input.

Sheets values can be passed via --values-json (recommended) or as inline rows.

Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).

Confirm before sending mail or creating events.