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 listsUtility Commands
# Current time
gog time now
gog time now --timezone America/New_York
# Auth status
gog auth list --check
gog auth statusTips
- 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