gog is a command-line client for Google Workspace that brings Gmail, Calendar, Drive, Docs, Sheets, and other Google services into the terminal.
The tool solves the problem of accessing Google Workspace through a unified command-line interface rather than web browsers or separate tools. It is built for people, scripts, CI pipelines, and agents that need explicit account routing, machine-readable output, and safety controls. Commands follow the resource being worked with—for example, gog gmail search for mail, gog calendar events for calendars, and gog drive ls for file operations. The tool supports the full breadth of Google Workspace, including contacts, tasks, meetings, chat, analytics, and workspace administration.
Adoption suits teams and individuals who work primarily in terminals, automate Google Workspace workflows, or need programmatic access with safety guarantees. The tool handles multiple Google accounts and OAuth client projects within a single installation, with tokens stored in the platform keyring by default or in encrypted files for headless systems. For automation, it offers structured JSON output and stable TSV format, with prompts and warnings directed to stderr. Safety features include a no-input mode, read-only enforcement, command allowlists, Gmail no-send policy, dry-run plans, and untrusted-content wrapping. Consumer Google accounts work with user-facing APIs, while admin features like Admin Directory and domain-wide delegation require a managed Google Workspace domain.
The maintainers typically respond to new issues and pull requests within a few days. Work in the issue tracker is dominated by lower-priority items and issues marked as requiring source reproduction or indicating that new fix pull requests are not being accepted.
