Gog

Name: Gog
Author: steipete

steipete/clawdis

5.1k installs
385k repo stars
Updated August 3, 2026
steipete/clawdis

gog is an agent skill for the Google Workspace CLI covering Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

About

gog is the Google Workspace CLI at gogcli.sh for Gmail, Calendar, Drive, Contacts, Sheets, and Docs automation from scripts and agent shells. One-time OAuth setup runs gog auth credentials with client_secret.json, gog auth add per account selecting gmail calendar drive contacts docs sheets services, and gog auth list for verification. Gmail covers thread search, per-message search ignoring threading, send with plain body, body-file, stdin heredocs, or HTML, drafts create and send, and reply with reply-to-message-id. Calendar lists and creates events with optional --event-color from IDs 1 through 11 via gog calendar colors. Drive search, contacts list, sheets get update append clear metadata, and docs export or cat are documented with --json for scripting. Email guidance prefers plain text via --body-file because --body does not unescape newlines; HTML uses --body-html with documented tags. Set GOG_ACCOUNT to avoid repeating --account; use --json and --no-input in scripts. Confirm before sending mail or creating events.

OAuth setup: gog auth credentials, gog auth add with service scopes, gog auth list.
Gmail search, per-message search, send via body-file stdin or HTML, drafts, and reply threading.
Calendar create and update with --event-color IDs 1-11 from gog calendar colors output.
Sheets get update append clear metadata and docs export cat with --json scripting flags.
Set GOG_ACCOUNT for default account; confirm before sending mail or creating calendar events.

Gog by the numbers

5,091 all-time installs (skills.sh)
+176 installs in the week ending Aug 2, 2026 (Skillselion tracking)
Ranked #72 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
Security screen: MEDIUM risk (skills.sh audit)
Data as of Aug 3, 2026 (Skillselion catalog sync)

At a glance

gog capabilities & compatibility

Capabilities: oauth credential and account setup · gmail search send drafts reply · calendar colored event management · drive search and contacts list · sheets and docs read export operations
Use cases: orchestration

From the docs

What gog says it does

Confirm before sending mail or creating events.

SKILL.md

npx skills add https://github.com/steipete/clawdis --skill gog

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/steipete/clawdis/gog.svg)](https://skillselion.com/skills/steipete/clawdis/gog)

Installs	5.1k
repo stars	★ 385k
Security audit	2 / 3 scanners passed
Last updated	August 3, 2026
Repository	steipete/clawdis ↗

How do I script Gmail sends, calendar events, drive search, or sheets updates from the terminal?

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs from the terminal with gog CLI after one-time OAuth setup.

Who is it for?

Developers automating Google Workspace tasks via gog CLI with OAuth credentials configured.

Skip if: Skip when Microsoft 365 or non-Google mail APIs are required instead of Google Workspace.

When should I use this skill?

User mentions gog, Gmail CLI, Google calendar terminal, sheets append, or gogcli.sh workflows.

What you get

Authenticated gog commands for read and write Google Workspace operations with scripting flags.

Sent emails or calendar events
Sheets updates and exported docs

By the numbers

Calendar event colors IDs 1 through 11 documented
Install via brew formula gogcli per skill metadata

Files

SKILL.mdMarkdownGitHub ↗

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 you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
gog auth list

Common commands

Gmail search: gog gmail search 'newer_than:7d' --max 10
Gmail messages search (per email, ignores threading): gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com
Gmail send (plain): gog gmail send --to a@b.com --subject "Hi" --body "Hello"
Gmail send (multi-line): gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt
Gmail send (stdin): gog gmail send --to a@b.com --subject "Hi" --body-file -
Gmail send (HTML): gog gmail send --to a@b.com --subject "Hi" --body-html "Hello"
Gmail draft: gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt
Gmail send draft: gog gmail drafts send <draftId>
Gmail reply: gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>
Calendar list events: gog calendar events <calendarId> --from <iso> --to <iso>
Calendar create event: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>
Calendar create with color: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7
Calendar update event: gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4
Calendar show colors: gog calendar colors
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>

Calendar Colors

Use gog calendar colors to see all available event colors (IDs 1-11)
Add colors to events with --event-color <id> flag
Event color IDs (from gog calendar colors output):
1: #a4bdfc
2: #7ae7bf
3: #dbadff
4: #ff887c
5: #fbd75b
6: #ffb878
7: #46d6db
8: #e1e1e1
9: #5484ed
10: #51b749
11: #dc2127

Email Formatting

Prefer plain text. Use --body-file for multi-paragraph messages (or --body-file - for stdin).
Same --body-file pattern works for drafts and replies.
--body does not unescape \n. If you need inline newlines, use a heredoc or $'Line 1\n\nLine 2'.
Use --body-html only when you need rich formatting.
HTML tags:  for paragraphs,   for line breaks,  for bold,  for italic, <a href="url"> for links, <ul>/<li> for lists.
Example (plain text via stdin):

  gog gmail send --to recipient@example.com \
    --subject "Meeting Follow-up" \
    --body-file - <<'EOF'
  Hi Name,

  Thanks for meeting today. Next steps:
  - Item one
  - Item two

  Best regards,
  Your Name
  EOF

Example (HTML list):

  gog gmail send --to recipient@example.com \
    --subject "Meeting Follow-up" \
    --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"

Notes

Set GOG_ACCOUNT=you@gmail.com 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.
gog gmail search returns one row per thread; use gog gmail messages search when you need every individual email returned separately.