Googleが、Google Workspace向けの新しいコマンドラインツール「Google Workspace CLI」をGitHubで公開した。ツール名は gws で、Drive、Gmail、Calendar、Sheets、Docs、Chat、Adminなど、Google Workspaceに関わる複数のAPIを単一のCLIから扱えるようにする構成を採る。AIエージェントから扱いやすいことも前面に打ち出されており、OpenClaw向けのskills導入手順やGemini CLI向けの拡張導入方法も案内されている。
今回の公開で注目すべきなのは、Google Workspaceの各サービスをまたぐ自動化の入口をひとつにまとめた点だ。これまでもGmailの送受信、Drive上のファイル操作、DocsやSheetsの作成、Calendar予定の追加といった処理は個別API経由で実行できたが、実際にはそれぞれ別のAPI仕様や認証設定、レスポンス処理を理解しながら組み合わせる必要があった。Google Workspace CLIは、その分散した操作系をCLIに集約し、開発者やAIエージェントがより統一的に扱えるようにしている。
Discovery Serviceを使い、コマンドを動的に構築する
GitHub上の説明では、gws は静的なコマンド一覧をあらかじめ埋め込む方式ではない。GoogleのDiscovery Serviceを実行時に参照し、その情報からAPIのリソースやメソッドに応じたコマンド体系を組み立てる。Google Workspace側で新しいAPIメソッドやエンドポイントが追加された場合でも、その情報を反映しやすい設計である。
この構造は、単に「CLIがある」という以上の意味を持つ。通常、Google Workspace関連の自動化は、サービスごとに別々のREST APIを追い、必要なパラメータや返却形式を理解し、場合によっては複数のAPIを順番につなぐ必要がある。たとえば、メールを受け取り、その添付や関連ファイルをDriveから探し、内容をDocsやSheetsへ転記し、Calendarに日程を入れるといった処理は、サービスをまたぐほど実装が煩雑になりやすい。gws は、その煩雑さを「Workspace API群を単一のCLIから呼び出す」という形に整理し直した。
リポジトリには具体例として、Driveファイル一覧の取得、Spreadsheetの作成、Chatメッセージの送信、メソッドのスキーマ確認などが載っている。gws drive files list、gws sheets spreadsheets create、gws chat spaces messages create、gws schema drive.files.list といった形で、各サービスごとの操作を同じ文法の延長で呼び出せる。CLIとしての統一感だけでなく、どのメソッドにどのリクエスト形式が必要かを調べやすいことも実務上は大きい。
構造化JSON出力とagent skillsでAI利用を意識
Google Workspace CLIの説明では、「人間向け」と「AI agents向け」が並列に示されている。人間向けには、REST APIドキュメントを見ながら curl を書く代わりに、--help や --dry-run、自動ページネーションなどを備えたCLIとして使える点が訴求されている。一方でAIエージェント向けには、レスポンスが構造化JSONで返ること、そしてagent skillsが含まれていることが特徴として挙げられている。
JSON出力は、AIエージェントとの相性がよい。人間が読むための整形済みテキストではなく、フィールド構造を保ったまま応答を返せるため、そのまま後段の処理へつなぎやすい。たとえばファイル一覧を受け取って条件に合うものだけを抽出する、取得した本文を別サービスに渡す、作成した予定や文書のIDを次のステップへ受け渡すといった使い方では、JSONのほうが扱いやすい。AIエージェントにとっても、曖昧なUI操作より、コマンド入力と構造化出力のほうが処理対象を把握しやすい。
リポジトリでは、100以上のAgent Skillsと50のレシピがあるとも案内されている。加えて、冒頭説明では「40+ agent skills included」との記述も見える。表現には差があるものの、CLI本体だけでなく、Workspace APIをどう扱うかを補助するスキル群をセットで整備している点は共通している。これは、単にAPIを叩く低レイヤーの道具を提供するだけではなく、AIエージェントにどのような作業をさせるかという上位レイヤーまで視野に入れていることを示している。
OpenClaw向けの導線がかなり具体的に用意されている
今回の公開が特に目を引くのは、OpenClaw向けの利用導線がかなり具体的に用意されている点だ。リポジトリには、skills/gws-* を ~/.openclaw/skills/ にシンボリックリンクする方法と、必要なskillだけをコピーする方法の両方が記載されている。さらに gws-shared skillには、gws がPATH上にない場合にnpm経由でCLIを自動導入する install ブロックが含まれると説明されている。
ここで重要なのは、「理論上OpenClawからも使える」というレベルではなく、OpenClawで使うことを想定した導入手順がドキュメントに組み込まれていることである。OpenClawのようなエージェント型ツールでは、どのサービスを呼び出せるか、どの操作単位で権限を与えるか、どの出力形式を受け取れるかが実用性を大きく左右する。Google Workspace CLIは、Gmail、Drive、Docs、Calendarなど複数サービスをまたぐ操作をCLIレベルで共通化し、それをskillの形でエージェントに接続しやすくしている。
Gemini CLI向けの手順も載っている。認証後に gemini extensions install https://github.com/googleworkspace/cli を実行することで拡張として組み込める構成で、端末側で確立した gws の認証を利用できる設計が示されている。Google自身が、ターミナル上で人が直接使うCLIと、AIエージェントが背後で使うCLIの両方を同じ枠組みで考えていることが分かる。
導入にはNode.js、Google Cloudプロジェクト、OAuth設定が必要
導入条件は比較的はっきりしている。基本のインストール方法は npm install -g @googleworkspace/cli で、Node.js 18以上が前提となる。GitHub Releasesからの取得や、Rustベースでソースからビルドする手順も案内されている。さらに、Google Cloudプロジェクトと、Google WorkspaceへアクセスできるGoogleアカウントも必要になる。
認証手段は複数ある。gws auth setup を使う方法、gws auth login でログインする方法、既存のアクセストークンを GOOGLE_WORKSPACE_CLI_TOKEN で渡す方法、認証ファイルを GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE で指定する方法などが用意されている。ローカルPCだけでなく、CIやサーバー環境での利用も想定した構成である。
とはいえ、導入時の作業がすべて不要になるわけではない。OAuth consent screenの設定、Credentialsの作成、テストユーザーの追加、Desktop app型OAuthクライアントの準備、必要APIの有効化など、Google Workspace APIを実際に使うための下準備は依然として必要である。ドキュメントには、未検証アプリ警告への対処、redirect_uri_mismatch の修正、必要なAPIが有効化されていない場合の403エラーの扱いまで含まれている。CLIが共通入口になったとはいえ、Google CloudとOAuthの前提知識が完全に不要になるわけではない。
Drive、Gmail、Calendar、Docsをまたぐ自動化の基盤になりそうだ
CLIとしての実用性を見ると、複数サービスをまたいだ処理を一貫した操作感で書けることが大きい。Driveのファイル一覧取得、DocsやSheetsの新規作成、Chatへの通知送信、Calendarへの予定追加といった操作が同じ gws の枠内に収まるなら、スクリプトやエージェントからの呼び出しは整理しやすい。特に、異なるサービスのレスポンス形式をJSONとしてそろえて受け取れることは、後続処理の設計を単純にする。
また、ページネーションやスキーマ確認がCLIに組み込まれている点も見逃せない。APIをまたいだ自動化では、1回の呼び出しで終わらない一覧取得や、引数の組み立てミスが手戻りの原因になりやすい。--page-all のような機能や gws schema ... の確認手段があれば、単に呼べるだけでなく、運用しながら調整しやすい。開発者向けツールとして見た場合でも、都度RESTドキュメントを読み直す負担を減らす方向に設計されている。
加えて、レスポンスのサニタイズにGoogle Cloud Model Armorを使う案内がある点は、AIエージェント利用をかなり意識したものだ。Gmail本文やDocs内のテキストをAIに渡す場合、プロンプトインジェクションのような問題が運用上の懸念になる。CLI側でそのリスクに対処する導線を持たせていることは、単なるAPIラッパーではなく、AI利用時の前処理まで視野に入れたツールとして位置付けていることを示している。
ただし現時点では正式サポート製品ではない
一方で、位置付けには明確な留保がある。リポジトリの説明には、このCLIが「not an officially supported Google product」であると記されている。Google名義のGitHubで公開されていても、現時点では正式サポート対象の製品ではない。機能や挙動が今後大きく変わる可能性があり、それによって既存のワークフローが壊れる場合があることも示されている。
この点は、特にAIエージェントと組み合わせて使う場合に重い。メール送信、ファイル作成、予定追加、チャット送信といった操作は便利である一方、誤操作や権限設定ミスの影響も大きい。CLIがWorkspace APIへの共通入口を与えてくれることと、業務で安全に使えることは別問題である。実際の導入では、どのスコープを許可するのか、どこまでを自動実行に任せるのか、どの操作で人間確認を挟むのかを事前に切り分ける必要がある。
Google Workspace CLIは、Google Workspaceを人間とAIエージェントの両方から扱うための共通基盤として見ると、かなり整理された公開内容である。Drive、Gmail、Docs、Calendarなどを単一CLIへ集約し、JSON出力、agent skills、OpenClaw導入手順、Gemini CLI拡張までそろえたことで、Workspace連携の自動化は試しやすくなった。ただし、現段階では未サポート製品であり、導入にはOAuth設定やAPI有効化、権限管理が伴う。まずは検証環境や限定的な用途で試し、どの操作をどの粒度でエージェントに渡すかを見極める段階にあると言えそうだ。
Sources
