Google Workspace CLI (gws)

Google Workspace CLI (gws)

Google Workspace CLI, branded as gws, is a command-line tool that gives humans and AI agents structured access to Drive, Gmail, Calendar, Sheets, Docs, Chat, and other Workspace APIs. It is designed to remove API boilerplate while keeping responses machine-friendly for agent workflows.

Prerequisites

Node.js or prebuilt gws binary, Google account, Google Cloud OAuth credentials

Installation

Use the upstream install or setup path that matches your environment:

• For convenience, you can also use npm to automate downloading the appropriate binary from GitHub Releases:
• npm install -g @googleworkspace/cli
• cargo install --git https://github.com/googleworkspace/cli --locked
• brew install googleworkspace-cli

Requirements and caveats from upstream:

• Prerequisites
• Node.js 18+ — for npm install (or download a pre-built binary from GitHub Releases)
• gws auth setup requires the gcloud CLI. If you don't have gcloud, use the manual setup below instead.

Basic usage or getting-started notes:

• Quick Start

• Advanced Usage

• A Google Cloud project — required for OAuth credentials. You can create one via the Google Cloud Console or with the gcloud CLI or...

• Source: https://github.com/googleworkspace/cli

• Extracted from upstream docs: https://raw.githubusercontent.com/googleworkspace/cli/HEAD/README.md

Documentation

• https://developers.google.com/workspace

Source

• Agent Skill Exchange