Blog

Google Workspace CLI の使い方：あなたにもできる！

Herve Kom

Herve Kom

17 3月 2026

Google Workspace CLI の使い方：あなたにもできる！

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

Google Workspace CLIとは

Google Workspace CLI（gwsとして呼び出される）は、GoogleのライブDiscovery Serviceから直接構築されたオープンソースの動的なコマンドラインツールであり、人間とAIエージェントにDrive、Gmail、Calendar、Sheets、Docs、Chat、Admin、およびすべてのGoogle Workspace APIへの統合されたアクセスを提供します。これにより、コマンドは更新なしで最新の状態を保ちます。Google Workspace CLIはnpm経由でグローバルにインストールし、OAuthで一度認証し、付属のスキルを使用してClaude CodeやCursorのようなエージェントに接続できます。定型的なOAuthフローや個別のSDKは不要です。

Google Workspace CLIとは何ですか？なぜ重要なのでしょうか？これは、すべての開発者、管理者、AIエージェントユーザーが直面する問題です。Google Workspaceサービス（Driveファイル、Gmailの送信、Calendarイベントの作成、Sheetsへの追加、Docsの編集、Chatへの投稿）を自動化または照会したい場合、カスタムのcurlスクリプトを作成したり、OAuthスコープに苦労したり、ページネーションを手動で処理したり、古くなった複数のSDKを繋ぎ合わせたりすることになります。

これは、GoogleのWorkspace APIが強力である一方で、断片化されているためです。各サービスには独自のエンドポイント、認証フロー、癖があります。従来のツールでは、APIの変更があると壊れてしまう定型コードを維持する必要があります。

Google Workspace CLIはこれを解決します。Googleチームによって2026年初頭にリリースされ（Addy Osmaniによって発表）、GoogleのDiscovery Serviceを使用して実行時にすべてのWorkspace APIメソッドを動的に検出する、単一のRustパワードCLIです。ツールの更新を待つことなく、新しいエンドポイントに即座にアクセスできます。

その結果、スクリプト、エージェント、および日々のターミナル作業は正確で最新の状態を保ちます。Google Workspace CLIは、クリーンなJSONを出力し、ドライラン、ページネーションヘルパーをサポートし、gws gmail +send や gws calendar +agenda のような40以上の人間が使いやすいショートカット（+で始まる）を含んでいます。

Google Workspace CLIは、すぐにインストールできるエージェントスキルも同梱しており、Claude Code、Cursor、OpenClaw、Gemini CLIなどのツールが、独自のツール定義を必要とせずに自律的にWorkspaceを管理できます。

Workspaceオートメーションと並行してAPIインテグレーションを構築またはテストしている場合、Apidogが検証側を処理します。これは、リクエストの送信、レスポンスの検査、環境の管理、テストスイートの実行を行うための無料のAPIクライアントです。Google Workspace CLIはデータへのライブアクセスを提供し、Apidogはすべての呼び出しが期待通りに動作することを確認します。

Google Workspace CLIのインストール唯一の要件はNode.js 18以降です。バージョンは次で確認できます。

node --version

インストールせずに実行するGoogle Workspace CLIを試す最も速い方法はnpxを使用することです（毎回最新版をプルします）。

npx @googleworkspace/cli --help
npx @googleworkspace/cli drive files list --params '{"pageSize":1}'

簡単なテストや一度限りのスクリプトに適しています。

グローバルにインストールする日常的に使用する場合は、gwsコマンドが常に利用できるようにグローバルにインストールします。

npm install -g @googleworkspace/cli
gws --version

Google Workspace CLIにはビルド済みのバイナリがバンドルされているため、起動は高速で、Rustをローカルでコンパイルする必要はありません。GitHub Releasesからバイナリを取得したり、Homebrew（brew install googleworkspace/cli）を使用したり、必要に応じてNix経由で実行したりすることもできます。

AIコーディングエージェント向けGoogle Workspace CLIのセットアップgws auth setupコマンドは、プロジェクトの作成、APIの有効化、初期OAuthを1つのガイド付きフローで処理します。以下を実行します。

gws auth setup

これによりブラウザが開き、必要に応じてGoogle Cloudプロジェクトが作成され、必要なAPIが有効になり、認証情報がOSのキーリングに安全に保存されます（AES-256-GCM暗号化）。

特定のAIエージェントを対象にするか、スキルをインストールするセットアップ後、バンドルされているエージェントスキルをインストールします。

npx skills add https://github.com/googleworkspace/cli

または、エージェント固有のインストーラー（例：Claude CodeやCursor用）を実行します。エージェントを再起動すると、Google Workspace CLIコマンドを自動的に検出します。

プロジェクトレベル vs. グローバルセットアップデフォルトでは、セットアップはグローバルに適用されます。プロジェクトのみの構成には：

gws auth setup --project

認証いつでも再認証またはアカウントを切り替えます。

gws auth login

現在のユーザーとスコープを確認します。

gws auth whoami

必要に応じてログアウトします。

gws auth logout

ヘッドレス/CIでの使用には、認証情報をエクスポートします。

gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.json

またはgcloudトークンを再利用します：export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)。

テレメトリー匿名利用状況収集を無効にします。

export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1

Google Workspace CLIでのコアコマンドの使用（Drive、Gmail、Calendar、Sheets、Docs、Chat）Google Workspace CLIはコマンドを動的に検出するため、固定されたリストはありません。利用可能なサービスを表示するには gws --help を実行します。

Driveのファイルとフォルダ最近のファイルを一覧表示します。

gws drive files list --params '{"pageSize":10, "q":"name contains report"}'

ヘルパーでアップロードします。

gws drive +upload ./budget.xlsx --name "2026 Budget"

Gmailメールを送信します。

gws gmail +send --to colleague@example.com --subject "Update" --body "See attached." --attach ./file.pdf

返信または受信トレイを整理します。

gws gmail +reply --message-id <ID> --body "Thanks!"
gws gmail +triage

Calendarイベントを作成します。

gws calendar +insert --summary "Sprint Planning" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "team@example.com"

今日の予定を表示します。

gws calendar +agenda --today

Sheets行を追加します。

gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Task X,Done,2026-03-16"

Docsテキストを挿入します。

gws docs +write --documentId <ID> --text "New section added via Google Workspace CLI"

Chatメッセージを投稿します。

gws chat +send --space <SPACE_ID> --text "Deployment complete 🚀"

任意のコマンドで --dry-run を使用すると、実行せずに正確なAPI呼び出しをプレビューできます。完全なページネーションとしてNDJSONで --page-all を追加します。

Google Workspace CLIの高度な設定とグローバルオプション環境変数または.envファイルで設定を永続化します。

export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'

タイムアウト、出力形式（--json、--yaml）を調整したり、ファイルベースのキーリングを強制したりします。設定を表示します。

gws config

Google Workspace CLIとAIエージェントおよびプロンプトの統合スキルがインストールされると、エージェントはGoogle Workspace CLIをネイティブに呼び出します。

「gwsを使用する」パターンプロンプトで：「Google Workspace CLIを使用して最近のDriveファイルを一覧表示してください」または「Google Workspace CLIを介してフォローアップメールを送信してください」。

自動呼び出しルールエージェントの指示（例：CLAUDE.mdまたはCursorルール）に追加します。

「タスクがGmail、Drive、Calendar、Sheets、Docs、またはChatを含む場合、応答する前にGoogle Workspace CLIコマンドを自動的に使用してください。まずサービスとメソッドを解決してください。」

エージェントはファイルパスまたはJSON結果を返し、コンテキストを簡潔に保ちます。

Apidogと組み合わせて完全なAPIの信頼性を実現Google Workspace CLIはWorkspace APIに即座にアクセスできるようにしますが、ペイロード、スコープ、またはレスポンスのデバッグ時には可視性が必要です。

Apidogは、リクエストの送信、生レスポンスの検査、OAuthトークンを使用した環境のセットアップ、アサーションの自動化を可能にする無料のAPIクライアントです。

実際のワークフロー：

Google Workspace CLI + Apidogは、ライブデータアクセスと検証済みで再現可能なAPIテストの両方を提供します。

FAQGoogle Workspace CLIは私のデータを外部に送信しますか？Google APIへの直接の呼び出しはありません。お客様のコンテンツがお客様のGoogleアカウントから離れることはありません。

Google Workspace CLIはどのサービスをサポートしていますか？Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin、Scriptなど、動的に検出されるすべてのWorkspace APIをサポートしています。

コマンドはどのくらい最新ですか？Google Workspace CLIはライブDiscovery Serviceにクエリを実行するため、新しいメソッドは自動的に表示されます。

APIキーが必要ですか？標準のGoogle OAuthまたはサービスアカウントを使用します。認証情報以外の個別のキーは必要ありません。

Google Workspace CLIはどのエージェントおよびエディターをサポートしていますか？Claude Code、Cursor、OpenClaw、Gemini CLI、VS Code拡張機能など、MCPまたはAgent Skills互換のすべてのツールをサポートしています。

生のコマンドと+ヘルパーの違いは何ですか？生（Raw）のコマンドは正確なDiscoveryメソッド（例：drive.files.list）を指します。+ヘルパーは一般的なタスク（例：+upload、+send）のショートカットです。

AIエージェントなしでGoogle Workspace CLIを使用できますか？はい、スクリプト、自動化、または日常のターミナル使用に最適です。

ボタン

その他のリソース

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる

無料会員登録ダウンロード