steveclarke gog-cli - Google Workspace CLI
Command-line tool for interacting with Google Workspace services.
Service References
Load only the reference file for the service you need:
- Email operations - See references/gmail.md
- Calendar & scheduling - See references/calendar.md
- File storage - See references/drive.md
- Spreadsheets - See references/sheets.md
- Documents & presentations - See references/docs-slides.md
- Contact management - See references/contacts.md
- Task lists - See references/tasks.md
- Team messaging - See references/chat.md
- Education/courses - See references/classroom.md
Global Options
Apply to any command:
| Option | Description |
|---|---|
--account <email|alias> |
Specify account to use |
--json |
Machine-readable JSON output |
--plain |
Tab-separated plaintext |
--force |
Skip confirmation prompts |
--no-input |
Fail rather than prompt (CI-friendly) |
--verbose |
Show API requests/responses |
Quick Examples
# Gmail: search recent emails
gog gmail search 'newer_than:7d' --max 10
# Calendar: today's events
gog calendar events primary --today
# Drive: list files
gog drive ls --max 20
# Sheets: read cells
gog sheets get <spreadsheetId> 'Sheet1!A1:B10'
# Tasks: list task lists
gog tasks lists
Utility Commands
# Current time
gog time now
gog time now --timezone America/New_York
# Auth status
gog auth list --check
gog auth status
Tips
- Use
--jsonfor scripting and piping to jq - Most IDs can be found in Google URLs (e.g., spreadsheet ID in sheets URL)
- Gmail search uses Google's search syntax (from:, to:, subject:, newer_than:, etc.)
- Calendar accepts "primary" as calendarId for main calendar