Google、AIエージェント対応の「Workspace CLI」をオープンソース公開

gwsは、Google Workspaceチームがオープンソースとして公開した統合コマンドラインツールだ。Gmail、Drive、Calendar、Docs、Sheets、Chatなどの全APIを単一のバイナリにまとめ、開発者だけでなくAIエージェントによる自動操作も視野に入れて設計されている。

gwsで何ができるのか

開発者がREST API仕様書とにらめっこしながらcurlを書く手間をなくすため、gwsは全リソースに対するヘルプ表示やドライラン実行、NDJSON形式での自動ページネーション出力に対応している。

日常の定型業務向けには、プラス記号から始まる便利なショートカットコマンドも用意された。未読メールを一覧するgws gmail +triageや、アカウントのタイムゾーンを自動判別して予定を表示するgws calendar +agenda、当日の予定とタスクをまとめるgws workflow +standup-reportなどがそのままターミナルから叩ける。

AIエージェントとの親和性も高い。すべての出力は構造化JSONで統一されており、リポジトリには40以上の標準エージェントスキルが同梱されている。OpenClawやGemini CLI拡張と組み合わせることで、LLMが外部ツール作成なしでWorkspace操作を自律実行できるようになる。

セキュリティ面ではGoogle Cloud Model Armorの統合に対応しており、受信メールなどのAPI応答に含まれるプロンプトインジェクションをAIモデルに渡す前に検知・無害化できる。

仕組みとエージェント連携

静的なコマンド一覧をパッケージ化する従来の手法と異なり、gwsは実行時にGoogle Discovery Serviceを参照してコマンドツリーを動的に組み立てる。これにより、Google Workspace側に新しいAPIエンドポイントが追加されても、ツール側をアップデートすることなく即座に利用できる。

認証方式もローカル環境からCIやサーバー運用まで柔軟に対応している。OSのキーリングを利用したAES-256-GCM暗号化保存に加え、環境変数経由でのアクセストークン指定やサービスアカウントの利用が可能だ。

注意点として、Google CloudのOAuthアプリが未検証のテストモードにある場合、同意可能なスコープが約25個に制限される。gwsの推奨プリセットは85以上のスコープを一括要求するため、個人のGmailアカウントなどでは特定サービスのみを指定してログインしなければエラーになる。

導入方法と注意点

導入はGitHub Releasesからのバイナリ直接配置のほか、npm、Homebrew、Nix flake、Cargo経由でのビルドに対応している。実行環境としてNode.js 18以上またはバイナリ実行環境、およびOAuth設定を行ったGoogle Cloudプロジェクトが必要となる。

公式ドキュメントでは、本ツールがGoogleの公式サポート製品ではなく、活発に開発が進められている実験的プロジェクトであると明記されている。バージョン1.0に向けて破壊的変更が入る可能性がある点には留意が必要だ。

なぜ重要か

AIエージェントに社内ツールを操作させる際、最も手がかかるのがAPI連携の糊付け作業だった。gwsは動的なスキーマ読み込みと構造化JSON出力によって、その摩擦を一気に解消している。

日常業務を自動化したい開発者にとって、すぐに試す価値のあるツールだと言える。ただし現時点では仕様変更のリスクやテストモードでの認証制限があるため、まずは個人環境や実験的プロトタイプから導入するのが無難だろう。