← Back to Skills Marketplace
czm448

Gog Local

by czm448 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
268
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gog-local
Description
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
README (SKILL.md)

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 [email protected] --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 [email protected] --subject "Hi" --body "Hello"
  • Calendar: gog calendar events \x3CcalendarId> --from \x3Ciso> --to \x3Ciso>
  • Drive search: gog drive search "query" --max 10
  • Contacts: gog contacts list --max 20
  • Sheets get: gog sheets get \x3CsheetId> "Tab!A1:D10" --json
  • Sheets update: gog sheets update \x3CsheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
  • Sheets append: gog sheets append \x3CsheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
  • Sheets clear: gog sheets clear \x3CsheetId> "Tab!A2:Z"
  • Sheets metadata: gog sheets metadata \x3CsheetId> --json
  • Docs export: gog docs export \x3CdocId> --format txt --out /tmp/doc.txt
  • Docs cat: gog docs cat \x3CdocId>

Notes

  • Set [email protected] 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.
Usage Guidance
This skill is instruction-only and coherent: it tells the agent to call a local 'gog' CLI that interacts with Google Workspace via OAuth. Before installing or using it: (1) verify the Homebrew tap/formula (steipete/tap/gogcli) and review the upstream project (https://gogcli.sh) or source code for the gog binary you will run; (2) be prepared to provide OAuth client_secret.json and to authorize the tool — doing so gives the binary access to your Gmail, Drive, Calendar, Contacts, Sheets, and Docs; (3) check where gog stores tokens on your system and revoke them if you stop trusting the tool; (4) when automating, use --no-input/--json as suggested and always confirm before sending mail or creating events. The skill itself contains no hidden code, but the runtime risk comes from the binary you install, so vet that binary before granting access.
Capability Analysis
Type: OpenClaw Skill Name: gog-local Version: 1.0.0 The skill bundle provides instructions and metadata for using 'gog', a legitimate CLI tool for Google Workspace. The installation method uses a known Homebrew tap (steipete/tap/gogcli), and the commands described in SKILL.md are standard operations for interacting with Gmail, Drive, and Sheets without any evidence of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions and the single required binary 'gog'. The SKILL.md documents Gmail/Calendar/Drive/Contacts/Sheets/Docs commands and shows the expected OAuth setup (client_secret.json and account add). Requiring the gog binary and OAuth is proportionate to the stated purpose.
Instruction Scope
SKILL.md only instructs the agent to run the gog CLI and to perform OAuth credential setup; it does not ask the agent to read unrelated system files, environment variables (aside from an optional GOG_ACCOUNT), or post data to unexpected endpoints. Commands operate on Google Workspace APIs as described and include reasonable cautions (e.g., confirm before sending mail).
Install Mechanism
Install uses a Homebrew formula (steipete/tap/gogcli) which is a third‑party tap rather than the core brew repo. Using brew is normal for installing CLI tools, but users should verify the tap/formula origin and contents before installing a binary that will access sensitive Google data.
Credentials
The registry metadata lists no required env vars or credentials, but the SKILL.md explicitly requires OAuth client credentials (client_secret.json) and creating an account token via 'gog auth add'. This is expected for a Google Workspace CLI, but users should be aware the CLI will store OAuth tokens locally and will be able to access their Google data once authorized.
Persistence & Privilege
Skill is not always-enabled, does not request elevated platform privileges, and does not modify other skills or global agent config. Any persistence is from the gog CLI's own OAuth token storage, which is outside the skill bundle and under the user's control.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gog-local
  3. After installation, invoke the skill by name or use /gog-local
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of gog-local – Google Workspace CLI for popular services. - Provides CLI commands for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. - Requires OAuth setup and supports multi-account authentication. - Includes common usage examples for each supported Google service. - Offers scripting and automation-friendly flags, like `--json` and `--no-input`. - Supports batch actions and metadata retrieval across services. - Caution: In-place Google Docs editing is not supported; only export, cat, and copy are available.
Metadata
Slug gog-local
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Gog Local?

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. It is an AI Agent Skill for Claude Code / OpenClaw, with 268 downloads so far.

How do I install Gog Local?

Run "/install gog-local" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gog Local free?

Yes, Gog Local is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gog Local support?

Gog Local is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gog Local?

It is built and maintained by czm448 (@czm448); the current version is v1.0.0.

💬 Comments