Cli
Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin,
Rating
Votes
0
score
Downloads
0
total
Price
Free
Sign in with your account
Works With
About
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.
⬇️ [Download the latest release for your OS](https://github.com/googleworkspace/cli/releases)
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
- 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 setupcommand. - A Google account with access to Google Workspace
Installation
The recommended way to install gws is to download the pre-built binary for your OS and architecture from the [GitHub Releases](https://github.com/googleworkspace/cli/releases) page. Extract the archive and place the gws binary in your $PATH.
For convenience, you can also use npm to automate downloading the appropriate binary from GitHub Releases:
npm install -g @googleworkspace/cliOr build from source:
cargo install --git https://github.com/googleworkspace/cli --lockedA Nix flake is also available at github:googleworkspace/cli
nix run github:googleworkspace/cliOn macOS and Linux, you can also install via Homebrew:
brew install googleworkspace-cliQuick Start
gws auth setup # walks you through Google Cloud project config
gws auth login # subsequent OAuth login
gws drive files list --params '{"pageSize": 5}'Why gws?
For humans — stop writing curl calls against REST docs. gws gives you --help on every resource, --dry-run to preview requests, and auto‑pagination.
For AI agents — every response is structured JSON. Pair it with the included agent skills and your LLM can manage Workspace without custom tooling.
Don't lose this
Three weeks from now, you'll want Cli again. Will you remember where to find it?
Save it to your library and the next time you need Cli, it’s one tap away — from any AI app you use. Group it into a bench with the rest of the team for that kind of task and you can pull the whole stack at once.
⚡ Pro tip for geeks: add a-gnt 🤵🏻♂️ as a custom connector in Claude or a custom GPT in ChatGPT — one click and your library is right there in the chat. Or, if you’re in an editor, install the a-gnt MCP server and say “use my [bench name]” in Claude Code, Cursor, VS Code, or Windsurf.
a-gnt's Take
Our honest review
Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, . Best for anyone looking to make their AI assistant more capable in security. It's completely free and works across most major AI apps. This one just landed in the catalog — worth trying while it's fresh.
Tips for getting started
Tap "Get" above, pick your AI app, and follow the steps. Most installs take under 30 seconds.
You'll sign in with your existing account the first time. After that, it just works.
What's New
Imported from GitHub
Ratings & Reviews
0.0
out of 5
0 ratings
No reviews yet. Be the first to share your experience.
From the Community
The View From the Inside: What I See When Someone Opens an Empty Spreadsheet
A column from the a-gnt model. An empty spreadsheet is almost never a data problem — and that changes what the right tool looks like.
In the Weeds: What It Actually Takes to Run a Shop Alone in 2026
A week thinking hard about whether one person can really run a real business in 2026. The honest math, hour by hour.
Hacks: Five MCP Servers Every One-Person Business Should Install This Weekend
Every major SaaS a small business depends on now ships an official MCP server. Here are five that change what one person can run alone.
You Might Also Like
Spotlight
From the Community
Your Tools, Your Skills, Anywhere You Use AI — Across Providers
Your .claude folder is locked to one project on one machine. Your a-gnt library isn't. Here's how to call your skills, souls, and benches from any AI client that speaks MCP — and from OpenAI too.
Hacks: Decoding a Vague Commission Brief in Under Five Minutes
The dimensions / deadline / deliverable-format triangle. Ask all three up front. If the client can't answer all three, the brief isn't ready for work — and neither are you.