Cli
A versatile command-line tool for interacting with Google Workspace APIs, designed for both human users and AI agents.
googleworkspace · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add googleworkspace/cliAbout this skill
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 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.
Contents
- Prerequisites
- Installation
- Quick Start
- Why gws?
- Authentication
- AI Agent Skills
- MCP Server
- Advanced Usage
- Environment Variables
- Architecture
- Troubleshooting
- Development
Prerequisites
- Node.js 18+ — for
npm install(or download a pre-built binary from [GitHub Releases](https://github.com/googleworkspace/cli/releases