# 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.

- Skill: `agentskillexchange/google-workspace-cli-gws` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/google-workspace-cli-gws`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/google-workspace-cli-gws/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/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](#prerequisites)
- **Node.js 18+** — for npm install (or download a pre-built binary from [GitHub Releases](https://github.com/googleworkspace/cli/releases))
- gws auth setup requires the [gcloud CLI](https://cloud.google.com/sdk/docs/install). If you don't have gcloud, use the [manual setup](#manual-oauth-setup-google-cloud-console) below instead.

Basic usage or getting-started notes:
- [Quick Start](#quick-start)
- [Advanced Usage](#advanced-usage)
- **A Google Cloud project** — required for OAuth credentials. You can create one via the [Google Cloud Console](https://console.cloud.google.com/) or with the [gcloud CLI](https://cloud.google.com/sdk/docs/install) 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](https://agentskillexchange.com/skills/google-workspace-cli-gws/)