---
name: gog
description: Read-only Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
homepage: https://gogcli.sh
metadata: {"clawdbot":{"emoji":"🎮","requires":{"bins":["gog"]}}}
---

# gog

Use `gog` for **read-only** Google Workspace access.

Never send mail, create events, update sheets, edit docs, delete files, or do any write operation through this tool.

The server already has a stored authorized-user credential at `~/.config/gog/credentials.json`.

## Auth

- Status: `gog auth list --json`
- Status alias: `gog auth status --json`

If auth is broken, report the failure and ask the human to re-authorize outside the bot flow. Do not try to create or rotate credentials from inside the bot.

## Common commands

- Gmail search: `gog gmail search 'newer_than:7d' --max 10 --json --results-only --no-input`
- Gmail get message: `gog gmail get <messageId> --json --no-input`
- Calendar list: `gog calendar list --max 20 --json --results-only --no-input`
- Calendar events: `gog calendar events primary --from 2026-03-01 --to 2026-03-31 --json --results-only --no-input`
- Contacts / People search: `gog people search "ignacio" --max 10 --json --results-only --no-input`
- Drive search: `gog drive search "invoice" --max 10 --json --results-only --no-input`
- Drive metadata: `gog drive get <fileId> --json --no-input`
- Docs get: `gog docs get <documentId> --json --no-input`
- Sheets values: `gog sheets values <spreadsheetId> "Tab!A1:D20" --json --no-input`

## Notes

- Prefer `--json` for scripting.
- Prefer `--results-only` when you only need the main list.
- Use `people`, not `contacts`, for search.
- If Gmail/Calendar/Drive/People calls work, the credential is live.