gog

name	gog
description	Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gog CLI. Use when asked to send emails, check calendar, search Drive, read/update spreadsheets, or interact with Google Workspace.
alwaysInclude	false
requiredBins	["gog"]
platforms	["darwin","linux"]

Google Workspace (gog)

Use gog for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. Requires OAuth setup.

Install

brew install steipete/tap/gogcli

Setup (Once)

gog auth credentials /path/to/client_secret.json
gog auth add [e-mail] --services gmail,calendar,drive,contacts,docs,sheets
gog auth list

Gmail

# Search threads
gog gmail search 'newer_than:7d' --max 10

# Search individual messages
gog gmail messages search "in:inbox from:[e-mail]" --max 20

# Send plain text
gog gmail send --to [e-mail] --subject "Hi" --body "Hello"

# Send multi-line (via file or stdin)
gog gmail send --to [e-mail] --subject "Hi" --body-file ./message.txt
gog gmail send --to [e-mail] --subject "Hi" --body-file - <<'EOF'
Hello,

Paragraph here.

Best regards
EOF

# Send HTML
gog gmail send --to [e-mail] --subject "Hi" --body-html "<p>Hello</p>"

# Create draft
gog gmail drafts create --to [e-mail] --subject "Hi" --body-file ./message.txt

# Reply
gog gmail send --to [e-mail] --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>

Calendar

# List events
gog calendar events <calendarId> --from <iso> --to <iso>

# Create event
gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>

# Create with color
gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7

# Update event
gog calendar update <calendarId> <eventId> --summary "New Title"

# Show available colors (IDs 1-11)
gog calendar colors

Drive

gog drive search "query" --max 10

Contacts

gog contacts list --max 20

Sheets

# Read cells
gog sheets get <sheetId> "Tab!A1:D10" --json

# Update cells
gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED

# Append rows
gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS

# Clear range
gog sheets clear <sheetId> "Tab!A2:Z"

# Get sheet metadata
gog sheets metadata <sheetId> --json

Docs

# Export to text
gog docs export <docId> --format txt --out /tmp/doc.txt

# Print content
gog docs cat <docId>

Notes

• Set GOG_ACCOUNT=[e-mail] to avoid repeating --account
• Use --json plus --no-input for scripting
• --body does not unescape \n; use --body-file or heredoc for multi-line
• Confirm before sending mail or creating events
• gog gmail search returns threads; gog gmail messages search returns individual messages