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:

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 --json for 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