Skill Detail

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.

Calendar, Email & ProductivityMulti-Framework
Calendar, Email & Productivity Multi-Framework Security Reviewed
⭐ 24.3k GitHub stars ⬇ 38.9k/wk npm
INSTALL WITH ANY AGENT
npx skills add agentskillexchange/skills --skill google-workspace-cli-gws Copy
Works best when you want a reusable capability, not another fragile one-off prompt.
At a glance
Tools required
Node.js or prebuilt gws binary, Google account, Google Cloud OAuth credentials
Install & setup
npm install -g @googleworkspace/cli
Author
googleworkspace
Publisher
Community
Last updated
Apr 8, 2026
Quick brief

Google Workspace CLI, distributed as gws, is a broad integration layer for Google Workspace that dynamically builds its command surface from Google’s Discovery Service. Instead of hand-writing separate wrappers for Gmail, Drive, Calendar, Sheets, Docs, Chat, and Admin APIs, users can authenticate once and then call Workspace resources through one consistent CLI that returns structured JSON. The upstream project explicitly positions this as useful both for human operators and AI agents, and the repository includes a large set of agent skills for higher-level workflows.

How it works

What this skill actually does

For ASE, the job-to-be-done is concrete: an agent can use gws to manage inboxes, inspect calendars, create spreadsheets, query Drive files, send Chat messages, and automate cross-service productivity tasks from one toolchain. The README documents OAuth setup, local and headless authentication flows, and multiple installation paths, including prebuilt binaries, npm, Cargo, Nix, and Homebrew. That makes it practical in both local desktop and server-style automation contexts.

The project has clear adoption and maintenance signals: a public GitHub repository, an npm package, release artifacts, Apache-2.0 licensing, and strong star activity with recent upstream commits. The documented npm install command is npm install -g @googleworkspace/cli, after which users can run authentication commands such as gws auth setup and gws auth login. Because it spans many Google services through a single automation entry point, it fits ASE’s productivity category as a real, source-verifiable integration tool.