gog

Installation
Summary

CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Google Workspace API.

  • Covers six Google services with commands for searching/sending emails, managing calendar events with color support, querying Drive, listing contacts, and reading/updating Sheets
  • Gmail operations include search, send (plain/HTML/multi-line), draft creation, and reply handling; supports multiple input methods (inline, file, stdin)
  • Calendar commands create, update, and list events with ISO date ranges and 11 built-in event colors
  • Sheets operations support get, update, append, clear, and metadata retrieval with JSON input/output
  • Requires one-time OAuth setup via gog auth with a Google client secret file; supports multiple accounts and environment variable configuration for scripting
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 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 "<p>Hello</p>"
  • Gmail draft: gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt
Related skills
Installs
3.0K
GitHub Stars
371.3K
First Seen
Jan 22, 2026