gog-cli

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