What do you want to do?
3 use cases
-
Script Gmail, Drive and Sheets from the terminal
Install gws, sign in once, and call any Workspace API with JSON in and JSON out.
- REPO
googleworkspace/cli - Work and operations
- Intermediate
View prompt
Install googleworkspace/cli, authenticate it, and write a script that lists my 20 most recent Drive files into a new Google Sheet called <title>. Use --dry-run first and show me the output.
- REPO
-
Give your coding agent Gmail, Drive and Calendar skills
Add the gws agent skills so your agent can use Workspace through the CLI.
View prompt
Add googleworkspace/cli's gws-gmail and gws-calendar skills to my agent, then draft (do not send) replies to my 3 most recent unread emails and list my meetings for tomorrow.
-
Triage your inbox and see your agenda with helper commands
Use the + helpers for common jobs like inbox triage, sending mail and your agenda.
View prompt
Using googleworkspace/cli helpers, show my agenda for today and run gmail +triage on unread mail, and summarise what needs a reply. Do not send anything.
Quick start with Google Workspace CLI
- Check you have what it needs: A Google account and a Google Cloud project for OAuth (gws auth setup walks you through it); npm, Homebrew, Cargo or Nix.
- Open googleworkspace/cli on GitHub and read the README and license.
- Install:
npm install -g @googleworkspace/cliorbrew install googleworkspace-cli - Run
gws auth setuponce, thengws auth login - List files:
gws drive files list --params '{"pageSize": 10}' - Create a sheet:
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'
These steps come from our top use case, Script Gmail, Drive and Sheets from the terminal, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for googleworkspace/cli
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeGoogle Workspace CLI alternatives · Best AI repos for Work and operations
About this repo
- Who it is forDevelopers, admins and agent builders who want to script Gmail, Drive, Calendar and Sheets without writing API boilerplate.
- Why it is hot32k stars, talked about in 2 AI sources we track
- LanguageRust
- Sourcegithub.com/googleworkspace/cli · Back to Hot repos
Requirements
- A Google account and a Google Cloud project for OAuth (gws auth setup walks you through it)
- npm, Homebrew, Cargo or Nix
Add this badge to your README
Maintain Google Workspace CLI? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/googleworkspace-cli/?utm_source=github&utm_medium=badge&utm_campaign=googleworkspace-cli)
HTML
<a href="https://dedupedai.com/use-cases/googleworkspace-cli/?utm_source=github&utm_medium=badge&utm_campaign=googleworkspace-cli"><img src="https://dedupedai.com/badge/googleworkspace/cli.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Google Workspace CLI
What is Google Workspace CLI?
gws is one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin and every other Google Workspace API, built for people and AI agents. It builds its commands at runtime from Google's Discovery Service, returns structured JSON, adds helper commands such as +send, +triage and +agenda, and ships 100+ agent skills. The README notes it is not an officially supported Google product and expects breaking changes before v1.0. It is an open-source project on GitHub: https://github.com/googleworkspace/cli.
How do I use Google Workspace CLI?
Install: npm install -g @googleworkspace/cli or brew install googleworkspace-cli; then run gws auth setup once, then gws auth login; List files: gws drive files list --params '{"pageSize": 10}'. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Google Workspace CLI for?
Developers, admins and agent builders who want to script Gmail, Drive, Calendar and Sheets without writing API boilerplate.
What can I do with Google Workspace CLI?
3 use cases so far, for example: Script Gmail, Drive and Sheets from the terminal; Give your coding agent Gmail, Drive and Calendar skills; Triage your inbox and see your agenda with helper commands. Each has steps and a copy-paste agent prompt.
What do I need to run Google Workspace CLI?
A Google account and a Google Cloud project for OAuth (gws auth setup walks you through it); npm, Homebrew, Cargo or Nix.
What are alternatives to Google Workspace CLI?
Other hot AI repos in Work and operations: Solidcraft, OpenDots, Dify, n8n, Sprawling Agents.
Is Google Workspace CLI safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.