Google Workspace CLI

googleworkspace-cli

A command-line interface for Google Drive, Gmail, Calendar, Sheets, Docs, Chat and Admin.

Runs as gws|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 7 fields

Run one Discovery-style call such as 'gws drive files list' with JSON params or body, optional dry-run and pagination. Auth setup, helper commands (+send, +agenda) and uploads are not covered.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui googleworkspace-cli

Call a Workspace APIExample values, fixed in this page — nothing here reaches a terminal

Basic

Service*

string

Resource and method*

string

Parameters (JSON)

string

Advanced

Fetch all pages

--page-all

Max pages

integer

TasksEach one presets the form for one job

List with all pages

servicemethod_pathparamspage_allpage_limit

Preview a write call

servicemethod_pathparamsjsondry_run

ParametersOnly these flags are editable in the form

Service

string · positional 0

drivegmailcalendarsheetschat

Resource and method

For example: files list, or spreadsheets create.
string · positional 1 · repeatable

Parameters (JSON)

string

--params

Request body (JSON)

string

--json

Dry run

Preview the request without sending it.
boolean

--dry-run

Fetch all pages

boolean

--page-all

Max pages

integer

--page-limit

SourcesEvery flag above is checked against these

readme

gws drive files list --params '{"pageSize": 5}' gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}' gws chat spaces messages create \ --params '{"parent": "spaces/xyz"}' \ --json '{"text": "Deploy complete."}' \ --dry-run gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name' | `--page-all`…

help2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed gws against its version. A form that does not match your version is not offered.