Master Google Workspace from the Command Line with the Gog Skill

If you've ever wished you could check your Gmail, manage calendar events, or manipulate Google Sheets without leaving your terminal or chat interface, the Gog skill is exactly what you need. This powerhouse skill connects Clawdbot to the entire Google Workspace suite—Gmail, Calendar, Drive, Contacts, Sheets, and Docs—through a single unified CLI.

What Problem Does This Solve?

Managing Google Workspace usually means juggling browser tabs, clicking through UI menus, and constantly context-switching. For developers, power users, and anyone who lives in the terminal, this friction adds up. Gog eliminates it by providing a fast, scriptable interface to Google's APIs.

Perfect for:

• Automating email workflows (search, send, label management)
• Creating calendar events from scripts or chat commands
• Querying and updating Google Sheets programmatically
• Searching Drive without opening a browser
• Building morning briefings that pull from multiple Google services

Installation

First, install the Gog CLI via Homebrew:

brew install steipete/tap/gogcli

Then install the skill for Clawdbot:

npx clawdhub@latest install gog

OAuth Setup (One-Time Configuration)

Gog requires OAuth credentials to access your Google account. Here's the setup:

1. Create OAuth credentials in Google Cloud Console and download the client_secret.json file.

2. Register your credentials:

gog auth credentials /path/to/client_secret.json

3. Authorize your account (select which services to enable):

gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs

4. Verify setup:

gog auth list

Pro tip: Set GOG_ACCOUNT=you@gmail.com in your environment to avoid repeating --account on every command.

Usage Examples

Gmail: Search and Send

Search recent emails:

gog gmail search 'newer_than:7d from:important@client.com' --max 10

Send an email (Clawdbot will confirm before sending):

gog gmail send --to colleague@company.com --subject "Quick update" --body "Here's the report you requested."

Mark messages as read:

gog gmail labels modify <message_id> --remove UNREAD

Calendar: Events Management

List upcoming events:

gog calendar events primary --from 2026-02-18T00:00:00Z --to 2026-02-25T00:00:00Z

Google Sheets: Read and Write Data

Read a range from a spreadsheet:

gog sheets get <sheetId> "Sheet1!A1:D10" --json

Update cells:

gog sheets update <sheetId> "Sheet1!A1:B2" --values-json '[["Header1","Header2"],["Value1","Value2"]]' --input USER_ENTERED

Append new rows:

gog sheets append <sheetId> "Sheet1!A:C" --values-json '[["new","row","data"]]' --insert INSERT_ROWS

Drive: File Search

Find files quickly:

gog drive search "quarterly report" --max 10

Docs: Export and Read

Export a Google Doc to plain text:

gog docs export <docId> --format txt --out /tmp/document.txt

Read document content:

gog docs cat <docId>

Tips and Best Practices

For scripting and automation, always use --json and --no-input flags to get machine-readable output and skip interactive prompts.

Batch operations: Combine with shell scripts to process multiple items—search emails, extract data, and update sheets in one workflow.

Security note: Gog stores OAuth tokens locally. The skill itself is created by the OpenClaw creator (steipete), so despite the "suspicious" warning, it's trustworthy—just verify any OAuth credentials you set up.

Limitations: In-place Google Docs editing requires the Docs API directly—Gog supports export, read, and copy operations.

Conclusion

The Gog skill transforms Clawdbot into a Google Workspace power tool. Whether you're building automated workflows, creating morning briefings, or just want faster access to your email and calendar, Gog delivers. With 132+ stars and 26k+ downloads, it's one of the most popular skills on ClawdHub for good reason.

Links:

• Gog on ClawdHub
• gogcli on GitHub