Google Workspace CLI (gws)

A unified CLI for Google Workspace APIs. Each product is accessed via gws <service> <command>.

Setup

Installation

The gws binary must be on $PATH. See the project repository for install options.

Authentication

# Browser-based OAuth — use -s to select only the services you need
gws auth login -s gmail,calendar,drive,sheets,docs,forms,slides,chat,tasks,keep

# Read-only OAuth when the task does not need writes
gws auth login --readonly