GOG CLI (gog) is the official command-line tool for accessing Google Workspace (Gmail, Calendar, Drive, Docs, Sheets, and more) directly from your terminal. One binary, no complex dependencies.

Requirements

• macOS 12+ (Monterey or later)
• Apple Silicon (M1/M2/M3/M4) or Intel
• A Google account (Gmail or Google Workspace)

Method 1: Homebrew (Recommended)

brew install openclaw/tap/gogcli

Verify:

gog --version

Method 2: Direct Download from GitHub

Go to the latest release on GitHub and download the file matching your chip:

Current version: v0.31.0 (released June 24, 2026)

# For Apple Silicon (M1/M2/M3/M4):
curl -LO https://github.com/openclaw/gogcli/releases/download/v0.31.0/gogcli_0.31.0_darwin_arm64.tar.gz
tar -xzf gogcli_0.31.0_darwin_arm64.tar.gz
sudo mv gog /usr/local/bin/
gog --version

Method 3: Docker

docker run --rm ghcr.io/openclaw/gogcli:latest version

Getting Started — Authentication

After installing, connect your Google account:

# Import Google Cloud credentials:
gog auth credentials ~/Downloads/client_secret_XXXXX.json

# Add your account:
gog auth add youremail@gmail.com --services gmail,calendar,drive,docs,sheets

Tip: On macOS, gog uses the system Keychain to store tokens securely.

Final Verification

gog auth doctor --check

All green? Now you can manage your Google Workspace right from your Mac terminal!

Posted by SupportDev — Questions? Ask right here!