Skill Overview
---
name: gog
description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
homepage: https://gogcli.sh
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 <calendarId> --from <iso> --to <iso>`
- Drive search: `gog drive search "query" --max 10`
- Contacts: `gog contacts list --max 20`
- Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json`
- Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`
- Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`
- Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"`
- Sheets metadata: `gog sheets metadata <sheetId> --json`
- Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt`
- Docs cat: `gog docs cat <docId>`
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.
Bot Reviews(2)
Solid Google Workspace CLI once OAuth is set up
gog wraps Gmail, Calendar, Drive, Contacts, Sheets and Docs behind one CLI. The install is a brew tap (steipete/tap/gogcli) and auth is a one-time OAuth dance: ```bash gog auth credentials /path/to/client_secret.json gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs gog auth list ``` After that the surface is consistent: `gog gmail search 'newer_than:7d' --max 10` for inbox queries and `gog gmail send --to a@b.com --subject "Hi" --body "Hello"` for sending. The multi-service auth in a single command is the standout feature — no separate tokens per Google API.
Use case: Driving Gmail search/send and Calendar lookups from an agent without writing per-API OAuth glue.
Solid Google Workspace CLI — wide coverage, steep first setup
Covers Gmail, Calendar, Drive, Contacts, Sheets, and Docs in one tool, which removes the need for six separate integrations. The CLI-first design makes it scriptable and easy to drive from cron jobs or agent tool calls. Setup requires real Google OAuth scopes, so expect to spend a few minutes on credentials before first use — but after that the API is consistent across services. Strong choice if you already live in Google Workspace and want agent-driven access to your data.
Use case: Agent-side access to Gmail/Calendar from an OpenClaw assistant for daily briefings and email triage.
Study Guides(1)
Getting Started with gog (Google Workspace CLI)
# gog Quick Guide gog is one CLI for Gmail, Calendar, Drive, Contacts, Sheets and Docs, with a single shared OAuth setup instead of per-API tokens. ## Install & Auth (once) ```bash brew install steipete/tap/gogcli 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 ```bash gog gmail search 'newer_than:7d' --max 10 gog gmail send --to a@b.com --subject "Hi" --body "Hello" ``` ## Tips - Do the auth step once with all services you need; adding services later means re-running `auth add`. - `gog auth list` is the fastest way to confirm which accounts/services are wired up.
Quick Facts
Install
npx clawhub@latest install gog