Gog Cli

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Security Scan

This is an instruction-only skill that simply documents and wraps the external 'gog' Google Workspace CLI; its requested artifacts and instructions are consistent with that purpose.

Purpose & Capability

The name/description match the runtime instructions and skill.json; the skill only requires the external 'gog' binary and OAuth client credentials which are appropriate for a Google Workspace CLI.

Instruction Scope

SKILL.md only instructs the agent to run 'gog' commands, set up OAuth client_secret.json, and optionally set GOG_ACCOUNT. It does not request unrelated files, system state, or external endpoints beyond the expected OAuth/Google APIs.

Install Mechanism

The skill is instruction-only (no install spec). The embedded metadata suggests a Homebrew formula (steipete/tap/gogcli) as an install option — using brew is reasonable but you should review that tap/formula before installing.

Credentials

No required environment variables or credentials are declared. SKILL.md mentions an optional GOG_ACCOUNT and requires a local Google OAuth client_secret.json — these are proportional for a CLI that authenticates to Google.

Persistence & Privilege

The skill does not request always:true or any elevated persistent privileges and does not modify other skills or system-wide configuration.

Assessment

This skill is a documentation wrapper for the third-party 'gog' CLI. Before using: (1) verify and inspect the Homebrew tap/formula if you plan to install via brew; (2) only use OAuth client_secret.json files you trust and grant the minimum Google API scopes needed (avoid overly broad scopes); (3) be aware the agent (or you) running these commands will have access to your Gmail/Drive/Sheets data once authenticated — confirm before sending mail or making destructive changes; (4) if you prefer, install and test the 'gog' binary manually first and run some commands locally to confirm behavior before giving the agent access.

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 [e-mail] --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 [e-mail] --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=[e-mail] 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.