Use this skill whenever the user wants to operate Google Workspace from the command line with gog/gogcli, including Gmail, Calendar, Drive, Docs, Sheets,…
gogcli (gog) gog is a fast, script-friendly CLI for Google services. It is JSON-first, supports multiple accounts/OAuth clients, and has explicit guardrails for agent and CI usage. Authoritative upstream: https://github.com/steipete/gogcli This skill was refreshed against upstream gog v0.13.0 (2026-04-20). When exact syntax matters, run gog <command> --help or gog schema --json; the command surface moves quickly, rather inconveniently for anyone fond of stale notes. Operating rules Prefer gog --json ... | jq ... for inspection and scripting. Use --plain only when stable TSV is more convenient than JSON. Use --dry-run for supported mutating operations when preparing a change or when user intent is ambiguous. Use --no-input in automation so commands fail instead of prompting. Use --force only when the user asked for the destructive/public/send/admin operation or after you have clearly explained the effect. Do not repair OAuth, consent, keyring, or Workspace delegation problems silently. Show the exact command the user should run. Do not export tokens, print secrets, open public shares, add delegates/forwarding, send mail, suspend users, or permanently delete data unless the user explicitly requested that action. For agent runs that must not send mail, add --gmail-no-send, set GOG_GMAIL_NO_SEND=1, or configure gog config no-send set <account>.
don't have the plugin yet? install it then click "run inline in claude" again.
added explicit decision points for auth repair, mail send, rate limits, and empty result sets; documented keyring credential storage and env var inputs; expanded procedure steps with error handling and dry-run workflows; clarified output contracts for both read and write operations; aligned voice to implexa standards.
gog is a fast, script-friendly CLI for Google services. use this skill whenever the user wants to operate Google Workspace from the command line, including Gmail, Calendar, Drive, Docs, Sheets, and other services. gog is JSON-first, supports multiple accounts and OAuth clients, and has explicit guardrails for agent and CI usage. this skill covers setup, authentication, common operations, and safety practices.
external docs: gog --help and gog schema --json for command schema. command surface moves quickly; check upstream for exact syntax when in doubt.
install gog (if not present).
authenticate a Google account.
gog auth login <account-email> or gog auth login for interactive prompt.gog auth list.list or switch accounts.
gog auth list to show all authenticated accounts and active account.gog auth use <account-email> to set active account.run a read operation (Gmail, Calendar, Drive, etc.).
gog gmail threads list or gog calendar events list), optional filters, output format preference.gog <service> <resource> <action> [options] --json for JSON output or --plain for TSV.gog <service> <resource> <action> --json | jq '.field'.[] or blank TSV. do not treat as error.run a write or mutating operation (send mail, create event, update doc, etc.).
gog <service> <resource> <action> [options] --dry-run to preview effect.gog <service> <resource> <action> [options] --force (if the action is destructive, sends mail, makes public, adds delegates, suspends users, or permanently deletes).--force may not be needed. some actions prompt for confirmation; use --no-input in automation to fail instead of hanging.handle authentication errors or token expiry.
gog auth login <account-email> --force-refresh.enable safety guards for agent or CI runs.
GOG_GMAIL_NO_SEND=1 (or configure: gog config no-send set <account>).--gmail-no-send flag to any gmail command.switch OAuth client (multi-client setups).
gog config oauth-client set <account> <client-id> or gog auth login <account-email> --client-id <id>.--force flag and confirm user intent first. do not send, delete, or change without user request.gog auth login --force-refresh).--plain. otherwise default to --json for inspection and piping.--no-input flag to fail fast instead.GOG_GMAIL_NO_SEND=1 env var or use --gmail-no-send flag.[] or blank TSV and inform user no matches found.gog <command> --help or gog schema --json to check current signature. upstream moves fast.--json) or TSV rows (with --plain), matching query filters. empty array [] or blank output if no results.[DRY RUN] marker.gog auth list or token refreshed without errors.--gmail-no-send or GOG_GMAIL_NO_SEND=1 fails explicitly if mail send is attempted, instead of sending.--force, sees final confirmation.credits: original skill by intellectronica. enriched for implexa quality standards.