googleworkspace/cli
OfficialGoogle Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.
Google Workspace CLI is googleworkspace's official open-source Rust command-line tool exposing Drive, Gmail, Calendar, Sheets, Docs, Chat, and Workspace Admin operations from one binary. Dynamically built from Google Discovery Service, with built-in skills for Gemini CLI agents.
Our Review
Google Workspace CLI is Google's official open-source command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, and Workspace Admin -- 26,300 stars and 1,400 forks in under three months as of May 2026. Built in Rust by googleworkspace and released under Apache 2.0, it dynamically generates commands from Google's Discovery Service so it covers every Workspace API surface with one binary.
What Google Workspace CLI does:
- •One command for every Workspace API dynamically built from the Google Discovery Service, so Drive, Gmail, Calendar, Sheets, Docs, Chat, and Admin all live in one tool.
- •Built-in AI agent skills exposes Workspace operations as agent skills usable by Gemini CLI and other MCP-aware coding agents.
- •Rust performance single static binary, no Node.js or Python runtime overhead, instant startup.
- •OAuth2 + service-account auth handles both personal Google account and Workspace admin authentication out of the box.
- •Gemini CLI extension ships as a Gemini CLI extension for one-line integration into the existing Gemini coding agent.
- •Cross-platform Windows, macOS, Linux binaries published as GitHub releases.
- •Apache 2.0 licensed commercial use permitted with attribution.
Google Workspace CLI ecosystem:
- •Google Discovery Service the API metadata source that makes the CLI auto-generate commands for any new Workspace surface.
- •Gemini CLI companion AI agent that uses Workspace CLI's skills to act on Drive, Gmail, and Calendar via natural language.
- •Google Cloud SDK the broader gcloud ecosystem for cloud infrastructure work (separate but complementary tool).
- •Workspace Admin SDK accessible via the CLI for IT admins managing user accounts, groups, and org policies.
Getting started:
Install Google Workspace CLI from the GitHub releases page or via Homebrew when available. Authenticate with gws auth login to use your personal Google account, or supply a service account JSON for unattended use. Run gws drive list or gws gmail search to verify. Full docs at developers.google.com/workspace.
Limitations:
Project is brand new (created March 2026), so expect occasional rough edges and breaking changes as the API surface stabilizes. The dynamic Discovery-based approach means every API call goes through one tool, which can mask differences in rate limits or behavior between Workspace APIs. Workspace Admin commands require admin privileges on the target domain. The "AI agent skills" feature is best paired with Gemini CLI -- other agents need manual configuration.
Our Verdict
Google Workspace CLI in 2026 is the cleanest official command-line interface to the entire Google Workspace API surface. 26,300 stars in three months, 1,400 forks, Apache 2.0, Rust-based for fast startup, and dynamically built from Google's Discovery Service so it covers Drive, Gmail, Calendar, Sheets, Docs, Chat, and Admin from a single binary.
For Vibe Builders working in Google Workspace environments, this CLI replaces a dozen ad-hoc Python scripts and Apps Script projects with one consistent tool. Pair with Gemini CLI for natural-language operations like "find all calendar events with Acme this month and send a summary to my manager."
For Developers, the dynamically generated command surface and Apache 2.0 license make this a strong base for automating Workspace workflows in CI/CD pipelines, internal tooling, or admin scripts. The Rust binary deploys cleanly into Docker, Lambda, or Cloud Run with no runtime dependencies.
Skip Google Workspace CLI if you only need a single Workspace API (the language-specific SDKs are simpler for one-shot integrations). Skip if you are not in the Google ecosystem -- this is Workspace-specific and has no Microsoft 365 or Notion equivalent. For Microsoft 365 work, the Microsoft Graph PowerShell SDK or the m365 CLI are the analogous tools.
Frequently Asked Questions
What is Google Workspace CLI?
Google Workspace CLI is Google's official open-source command-line tool that exposes Drive, Gmail, Calendar, Sheets, Docs, Chat, and Workspace Admin operations from one binary. Built in Rust and maintained by googleworkspace under Apache 2.0, it dynamically generates commands from the Google Discovery Service. As of May 2026 it has 26,300 GitHub stars after only three months.
Is Google Workspace CLI free?
Yes. The CLI is free and open source under Apache 2.0. You will need a Google account or Workspace account to authenticate, and any quotas on the underlying APIs (Gmail send limits, Drive storage, Workspace Admin permissions) still apply. There is no separate paid tier for the CLI itself.
How does it work with Gemini CLI?
Google Workspace CLI ships as a Gemini CLI extension. After installing both, your Gemini CLI agent can call Workspace operations as built-in skills. For example, you can ask Gemini to 'list my calendar for tomorrow and email the agenda to Bob,' and it will call the Workspace CLI under the hood. The agent-skills feature is the canonical integration point.
How do I install Google Workspace CLI?
Download the latest binary from the GitHub releases page at github.com/googleworkspace/cli/releases. Binaries are available for Windows, macOS, and Linux. Move the binary into your PATH and run gws auth login to authenticate with your personal Google account. For service accounts, supply the JSON credentials file path via environment variable or flag.
Does it work with Microsoft 365?
No. Google Workspace CLI is Workspace-specific. For Microsoft 365, look at the official Microsoft Graph PowerShell SDK or the community m365 CLI (github.com/pnp/cli-microsoft365), which offer similar coverage of the Microsoft API surface. The two are complementary tools for organizations running both ecosystems.
What is cli?
Google Workspace CLI is googleworkspace's official open-source Rust command-line tool exposing Drive, Gmail, Calendar, Sheets, Docs, Chat, and Workspace Admin operations from one binary. Dynamically built from Google Discovery Service, with built-in skills for Gemini CLI agents.
What license does cli use?
cli uses the Apache-2.0 license.
What are alternatives to cli?
Explore related tools and alternatives on My AI Guide.
Open source & community-verified
Apache-2.0 licensed: free to use in any project, no strings attached. 26,447 developers have starred this, meaning the community has reviewed and trusted it.
Reviewed by My AI Guide for relevance, quality, and active maintenance before listing.
Topics