Google Workspace

Google Workspace Alert Center

Name: Google Workspace Alert Center
Author: Google Workspace

Security community Intermediate

SOURCE https://github.com/googleworkspace/cli

Description

- [Prerequisites](#prerequisites) - [Installation](#installation) - [Quick Start](#quick-start) - [Why gws?](#why-gws) - [Authentication](#authentication) - [AI Agent Skills](#ai-agent-skills) - [Advanced Usage](#advanced-usage)

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for googleworkspace/cli, shared by 4 entries in this directory. It describes the repository, not this entry specifically.

gws

**One CLI for all of Google Workspace — built for humans and AI agents.**

Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JSON output. 40+ agent skills included.

[!NOTE] This is **not** an officially supported Google product.

npm install -g @googleworkspace/cli

`gws` doesn't ship a static list of commands. It reads Google's own [Discovery Service](https://developers.google.com/discovery) at runtime and builds its entire command surface dynamically. When Google Workspace adds an API endpoint or method, `gws` picks it up automatically.

[!IMPORTANT] This project is under active development. Expect breaking changes as we march toward v1.0.

Prerequisites
Installation
Quick Start
Why gws?
Authentication
AI Agent Skills
Advanced Usage
Environment Variables
Exit Codes
Architecture
Troubleshooting
Development

Prerequisites

Node.js 18+ — for npm install (or download a pre-built binary from GitHub Releases)
A Google Cloud project — required for OAuth credentials. You can create one via the Google Cloud Console or with the `gcloud` CLI or with the gws auth setup command.
A Google account with access to Google Workspace