# Install googleworkspace-cli with Homebrew, MacPorts, pacman, Nix, winget CLI for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Version 0.22.5 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:googleworkspace-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install googleworkspace-cli ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install googleworkspace-cli ``` Evidence: MacPorts ports tree: office/googleworkspace-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - pacman (92%): ```sh sudo pacman -S googleworkspace-cli ``` Evidence: Arch Linux sync databases: googleworkspace-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#gws ``` Evidence: nixpkgs package indexes: pkgs/by-name/gw/gws/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - winget (92%): ```sh winget install --id Google.WorkspaceCLI -e ``` Evidence: Windows Package Manager source index: Google.WorkspaceCLI from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:googleworkspace-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.22.5 - **Source summary:** CLI for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - gws (cli) - gws (alias) ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.22.5 - Local data: ok - Upstream repository: https://github.com/googleworkspace/cli - Upstream latest detected: v0.22.5 (current) - info: No package-manager update timestamp was available. ## Project history and usage Google Workspace CLI, invoked as `gws`, is a command-line tool for Google Workspace APIs such as Drive, Gmail, Calendar, Sheets, Docs, Chat, and Admin. Its README describes a dynamic command surface built from Google's Discovery Service, structured JSON output, and included agent skills. ### Project history The GitHub repository was created in March 2026 and began with rapid 0.x releases. The README explicitly says the project is not an officially supported Google product while placing it in the Google Workspace developer ecosystem. The tool is written for both human CLI users and AI-agent workflows. Its installation paths include prebuilt GitHub release binaries, npm distribution as `@googleworkspace/cli`, source builds with Cargo, Nix, and Homebrew. ### Adoption history Because the project is young, its adoption history is mainly packaging and workflow positioning rather than a long ecosystem record. The official README documents Homebrew installation, npm installation, a Nix flake, Gemini CLI extension setup, and Skills installation from the repository. ### How it is used Typical use starts with `gws auth setup` or `gws auth login`, then commands such as listing Drive files, creating Sheets resources, sending Chat messages, or inspecting generated schemas. The README documents OAuth credential files, exported credentials for headless use, pre-obtained access tokens, and environment-variable precedence. ### Why package nerds care For package nerds, gws is interesting because it packages a broad API family as a generated CLI rather than hand-written subcommands. It also reflects a 2026-era packaging pattern: one binary, npm bootstrap, Homebrew formula, Nix flake, structured JSON output, and agent skill bundles. ### Timeline - 2026: GitHub repository created under googleworkspace/cli. - 2026: 0.1.2 published on GitHub Releases in March. - 2026: 0.22.5 published on GitHub Releases in March after a rapid 0.x release series. - 2026: Homebrew formula and npm installation documented in the README. ### Related projects - The README relates gws to Google Workspace APIs, Google's Discovery Service, Google Cloud OAuth setup, the gcloud CLI, Gemini CLI extensions, and repository-provided agent skills. ### Sources - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Credential files - Unix: ~/.config/gws/client_secret.json, ~/.config/gws/credentials.json, $GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** googleworkspace-cli - **Version Scheme:** 0 - **Revision:** 0 - **Conflicts With:** gws - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - pacman - googleworkspace-cli - 0.22.5-1: normalized package name match | Arch Linux sync databases: googleworkspace-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more | https://developers.google.com/workspace - MacPorts - googleworkspace-cli: normalized package name match | MacPorts ports tree: office/googleworkspace-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - MacPorts - gws: installed executable or alias match | MacPorts ports tree: devel/gws/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Nix - gws: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/gw/gws/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - winget - Google.WorkspaceCLI: installed executable or alias match | Windows Package Manager source index: Google.WorkspaceCLI from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Documentation packages](https://www.automicvault.com/pkg/documentation-tools/) - Matched documentation, manual, or publishing metadata. - [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [gogcli](https://www.automicvault.com/pkg/brew/gogcli/) - Shares av.db curated category or tags: automation, cli, gmail, google-workspace, productivity. - [gmailctl](https://www.automicvault.com/pkg/brew/gmailctl/) - Shares av.db curated category or tags: automation, cli, gmail, productivity. - [gyb](https://www.automicvault.com/pkg/brew/gyb/) - Shares av.db curated category or tags: cli, gmail, google-workspace, productivity. - [mcp-google-sheets](https://www.automicvault.com/pkg/brew/mcp-google-sheets/) - Shares av.db curated category or tags: automation, cli, google-drive, productivity. - [deck](https://www.automicvault.com/pkg/brew/deck/) - Shares av.db curated category or tags: automation, cli, productivity. - [dockutil](https://www.automicvault.com/pkg/brew/dockutil/) - Shares av.db curated category or tags: automation, cli, productivity. - [esniper](https://www.automicvault.com/pkg/brew/esniper/) - Shares av.db curated category or tags: automation, cli, productivity. - [flexget](https://www.automicvault.com/pkg/brew/flexget/) - Shares av.db curated category or tags: automation, cli, productivity. ## Combined YAML source View the package source record on GitHub. [combined/googleworkspace-cli.yml](https://github.com/automic-vault/db/blob/main/combined/googleworkspace-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph