googleworkspace/cli

GWS

Google Workspace全体に1つのCLIで — 人間とAIエージェント向けに作られています。 Drive、Gmail、カレンダー、そしてすべてのWorkspace APIに対応しています。定型文はゼロです。構造化されたJSON出力。40+のエージェントスキルも含まれています。

[!注] これは公式にサポートされているGoogle製品ではありません。

⬇️ あなたのOS向けに最新リリースをダウンロードしてください

gwsは静的なコマンドリストを提供しません。実行時にGoogleのディスカバリーサービスを読み取り、そのコマンド表面全体を動的に構築します。Google WorkspaceがAPIエンドポイントやメソッドを追加すると、gwsは自動的にそれを拾います。

[!重要] このプロジェクトは現在進行中です。v1.0に向けた段階で、画期的な変更が期待できます。

内容

• 前提条件
• 設置
• クイックスタート
• なぜGWSなんだ?
• 認証
• AIエージェントスキル
• 高度な使用法
• 環境変数
• 出口コード
• 建築
• トラブルシューティング
• 開発

前提条件

• Node.js 18+ — npm install用(またはGitHub Releasesから事前構築済みのバイナリをダウンロード)
• Google Cloudプロジェクト — OAuth認証情報に必要です。Google Cloud Console、またはgcloud CLI、またはgws auth setupコマンドで作成できます。

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

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 setup command.
• 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 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/cli

Or build from source:

cargo install --git https://github.com/googleworkspace/cli --locked

A Nix flake is also available at github:googleworkspace/cli