{"slug": "google-workspace-cli-unified-command-line-tool-built-for-humans-and-ai-agents", "title": "Google Workspace CLI: Unified Command-Line Tool Built for Humans and AI Agents", "summary": "Google released a new Google Workspace CLI tool that provides a unified command-line interface for Drive, Gmail, Calendar, Sheets, Docs, Chat, and Admin APIs. Written in Rust, the tool dynamically generates commands from Google's Discovery Service and includes over 100 agent skills for AI workflows, though the project is not an officially supported Google product and remains in active development with potential breaking changes.", "body_md": "A new [Google Workspace CLI ](https://github.com/googleworkspace/cli)has been released that provides a single interface to Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin and every other Google Workspace API. Written in Rust and licensed under Apache 2.0, the CLI is designed to serve both human operators and AI agent workflows, shipping with structured JSON output and over 100 bundled agent skills.\n\nUnlike traditional CLI tools that ship with a static list of commands, `gws`\n\nreads Google's own [Discovery Service](https://developers.google.com/discovery) at runtime and builds its entire command surface dynamically. When Google adds or updates an API endpoint, the CLI picks up the change automatically without requiring a new release. The tool also includes a set of helper commands, prefixed with `+`\n\n, for common workflows such as sending emails, triaging inboxes and generating standup reports.\n\nGetting started requires Node.js 18 or later (or a pre-built binary from [GitHub Releases](https://github.com/googleworkspace/cli/releases)), a Google Cloud project for OAuth credentials and a Google account with Workspace access. Installation can be handled via npm, Homebrew, Cargo or Nix:\n\n```\nnpm install -g @googleworkspace/cli\n```\n\nOnce installed, initial setup and authentication are handled through two commands:\n\n```\ngws auth setup\ngws auth login\n```\n\nFrom there, interacting with Workspace services follows a consistent pattern. Listing recent Drive files, for example, is a single call:\n\n```\ngws drive files list --params '{\"pageSize\": 10}'\n```\n\nThe agent skills ecosystem is a core offering. Skills are packaged as `SKILL.md`\n\nfiles covering every supported API, and the CLI also includes an MCP server option for connecting to tools such as Claude Code and Gemini CLI. Google Cloud director Addy Osmani [introduced the CLI](https://x.com/addyosmani/status/2029372736267805081) as \"built for humans and agents\". The repository has since gathered over 26,500 stars on GitHub.\n\nCommunity response has been mixed. On [Hacker News](https://news.ycombinator.com/item?id=47255881), several users praised the dynamic command generation and the broader shift toward CLI-first tooling.\n\nOne commenter observed that:\n\nCompanies are finally putting APIs in front of things that should have had APIs for years\n\nAnother warned:\n\nThis is not an officially supported Google product.\n\nWhich is specified as a note on the [GitHub Readme](https://github.com/googleworkspace/cli/blob/main/README.md), along with a warning that the project is in active development and breaking changes are expected.\n\nA Hacker News user [reported](https://news.ycombinator.com/item?id=47255881) spending 45 minutes following the default setup flow, only to hit scope limits and verification errors:\n\nMultiple errors and issues along the way, now I'm on\n\n`gws auth login`\n\n, and trying to pick the oAuth scopes. I go ahead and trust their defaults and select`recommended`\n\n, only to get a warning that this is too many scopes and may error out (then why is this the recommended setting??), and then yeah, it errors out when trying to authenticate in the browser.\n\nOn [Reddit](https://www.reddit.com/r/gsuite/comments/1rw82qt/googles_new_workspace_cli_makes_gmaildrive/), the reception was warmer. One user connected `gws`\n\nto Claude Code and had the agent read, summarise and act on emails, calling the experience \"way easier\" than previous scripting approaches. The community-driven [CLI for Microsoft 365](https://pnp.github.io/cli-microsoft365/) offers a comparable surface for the Microsoft ecosystem, currently at version 11.7.0 with support for SharePoint, Teams, Entra ID and Power Platform. Unlike `gws`\n\n, it ships a static command set via npm rather than generating commands dynamically, though it benefits from a mature plugin architecture and a more straightforward authentication flow.\n\nFull setup instructions, authentication options and a troubleshooting guide are available in the [repository README](https://github.com/googleworkspace/cli).", "url": "https://wpnews.pro/news/google-workspace-cli-unified-command-line-tool-built-for-humans-and-ai-agents", "canonical_source": "https://www.infoq.com/news/2026/06/google-workspace-cli/?utm_campaign=infoq_content&utm_source=infoq&utm_medium=feed&utm_term=global", "published_at": "2026-06-02 06:33:00+00:00", "updated_at": "2026-06-02 20:19:26.057275+00:00", "lang": "en", "topics": ["ai-tools", "ai-agents", "ai-products", "ai-infrastructure"], "entities": ["Google Workspace", "Google", "Rust", "Apache 2.0", "Node.js", "GitHub", "npm", "Homebrew"], "alternates": {"html": "https://wpnews.pro/news/google-workspace-cli-unified-command-line-tool-built-for-humans-and-ai-agents", "markdown": "https://wpnews.pro/news/google-workspace-cli-unified-command-line-tool-built-for-humans-and-ai-agents.md", "text": "https://wpnews.pro/news/google-workspace-cli-unified-command-line-tool-built-for-humans-and-ai-agents.txt", "jsonld": "https://wpnews.pro/news/google-workspace-cli-unified-command-line-tool-built-for-humans-and-ai-agents.jsonld"}}