Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Downloads
33.9k
Stars
248
Versions
1
Updated
2026-02-23
Install
npx clawhub@latest install gog
Documentation
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.comto avoid repeating--account. - -For scripting, prefer
--jsonplus--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.
Launch an agent with Gog on Termo.