← Back to Skills Marketplace
123
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cs-gog
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.jsongog auth add [email protected] --services gmail,calendar,drive,contacts,sheets,docsgog 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
--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.
Usage Guidance
This skill appears to be what it says (a CLI wrapper for Google Workspace), but take these steps before installing:
- Verify the Homebrew tap and formula source (steipete/tap/gogcli) and confirm the upstream repo or website (https://gogcli.sh) are trustworthy.
- Understand that you must supply OAuth client credentials (client_secret.json) and that the tool will store tokens locally; check where tokens/config are saved and whether they are encrypted.
- Review and minimize OAuth scopes when running 'gog auth add' (don’t grant more permissions than necessary).
- Be aware the skill can read/send email and access drive/docs; if you don’t want an autonomous agent performing those actions, disable autonomous invocation or require manual confirmation for sensitive commands.
- If you need extra caution, install and run the CLI in an isolated environment (VM/container) and inspect the Homebrew formula source before installing.
If you want, provide the Homebrew formula or upstream repo URL and I can review it for additional concerns.
Capability Analysis
Type: OpenClaw Skill
Name: cs-gog
Version: 1.0.0
The skill bundle provides a legitimate interface for the 'gog' CLI tool to interact with Google Workspace services (Gmail, Drive, Sheets, etc.). The SKILL.md file contains standard documentation for installation via a Homebrew tap (steipete/tap/gogcli) and typical command usage patterns without any evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
The skill declares and requires the 'gog' binary and the SKILL.md exclusively documents gmail/calendar/drive/contacts/sheets/docs operations — the requested binary and commands are coherent with the stated Google Workspace purpose.
Instruction Scope
SKILL.md instructs the agent to run 'gog' commands that perform sensitive operations (read/send mail, read/write Drive/Sheets/Docs, list contacts). This is expected for the claimed purpose, but the instructions rely on a user-provided OAuth client_secret.json and token setup which are not listed in requires.env/primaryEnv. The skill explicitly advises confirming before sending mail, which is good.
Install Mechanism
Install uses a Homebrew formula 'steipete/tap/gogcli'. Brew installs are common, but this is a third‑party tap (not core/homebrew). Users should verify the tap owner and formula source before installing because third‑party taps can deliver arbitrary code.
Credentials
The skill declares no required env vars, yet runtime setup requires OAuth client credentials (client_secret.json) and will create/hold OAuth tokens; GOG_ACCOUNT is suggested as an env var. These credentials are sensitive and effectively required for functionality but are not surfaced in the metadata. That mismatch reduces transparency about needed secrets and where they will be stored.
Persistence & Privilege
The skill is not always-enabled, but model invocation is allowed (default). Because the CLI can read/send email and modify documents, autonomous invocation increases blast radius — consider requiring explicit user confirmation for sensitive operations or disabling autonomous use if you want stricter controls.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cs-gog - After installation, invoke the skill by name or use
/cs-gog - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of cs-gog: Google Workspace CLI skill.
- Adds commands for managing Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the `gog` CLI.
- Includes setup instructions for OAuth and account linking.
- Provides example usage for common tasks such as Gmail search, sending mail, viewing calendar events, managing Drive files, listing contacts, and manipulating Sheets and Docs.
- Notes on environment setup, scripting options, and safety confirmations for sensitive actions.
Metadata
Frequently Asked Questions
What is cs-gog?
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.
How do I install cs-gog?
Run "/install cs-gog" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is cs-gog free?
Yes, cs-gog is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does cs-gog support?
cs-gog is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created cs-gog?
It is built and maintained by snilpmud (@snilpmud); the current version is v1.0.0.
More Skills