Google Workspace CLIとは？Drive・Gmail・CalendarをAIエージェントと連携する「gws」の全貌

📖 この記事で分かること

• Google公式リポジトリ発のCLIツール「gws」の概要と特徴
• AIエージェント向け100以上のスキルとMCPサーバー機能
• OpenClaw・Gemini CLI・Claude Desktopとの連携方法
• インストールから認証までの基本的な使い方

💡 知っておきたい用語

• Discovery Service【ディスカバリーサービス】：GoogleがAPIの仕様を動的に配布する仕組み。gwsはこの仕組みを利用することで、Googleが新しいAPIを追加するたびに自動でコマンドを拡張できます。

最終更新日: 2026年03月06日

Google Workspace CLIとは何か

gws（Google Workspace CLI）は、Drive・Gmail・Calendar・Sheets・Docs・Chat・Adminをはじめとする主要なGoogle Workspace APIを、コマンドライン一本で操作できるオープンソースツールです。Google Workspaceの公式GitHubリポジトリ（googleworkspace/cli）でホストされており、2026年3月5日時点でv0.3.5がリリースされています。

主な特徴は次のとおりです。

• 動的コマンド生成: コマンドの一覧をソースコード内に静的に持たない。起動時にGoogle Discovery Serviceから仕様を取得し、コマンドツリーをリアルタイムで構築します。GoogleがAPIに新メソッドを追加すると、gwsは次回起動時から自動的にそのコマンドを利用できます。
• 構造化JSON出力: すべてのレスポンスがJSON形式で返されるため、AIエージェントによる後処理・解析がしやすい設計になっています。
• AIエージェントスキル同梱: 100以上のSKILL.mdファイルを同梱しており、LLMがWorkspaceを操作するためのカスタムツールを別途作成する必要がありません。

Rustで実装されており、npmパッケージ（@googleworkspace/cli）として配布されています。

npm install -g @googleworkspace/cli
gws auth setup
gws drive files list --params '{"pageSize": 5}'

なお、プロジェクトの説明には「これはGoogleが公式にサポートするプロダクトではない」と明記されています。活発に開発中であり、v1.0に向けて破壊的変更が生じる可能性があるとされています。

AIエージェント向け機能：スキルとMCPサーバー

gwsには、AIエージェントとの連携を想定した機能が二本柱で提供されています。

100以上のエージェントスキル

リポジトリにはskills/ディレクトリに100以上のSKILL.mdファイルが含まれています。Gmail・Drive・Docs・Calendar・Sheets向けの50のレシピを含む「上位ワークフロー用ヘルパー」も含まれており、APIごとに1つのスキルが用意されています。

OpenClawやその他のAIエージェントランタイムへのインストール方法も公式ドキュメントに明記されています。

# 全スキルを一括インストール
npx skills add https://github.com/googleworkspace/cli

# OpenClawへのシンボリックリンク（リポジトリと同期）
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

MCPサーバー機能

gws mcpコマンドで、MCPプロトコル【モデルコンテキストプロトコル】対応クライアント（Claude Desktop・Gemini CLI・VS Codeなど）からGoogle Workspace APIを構造化ツールとして呼び出せるMCPサーバーが起動できます。

gws mcp -s drive,gmail,calendar   # 複数サービスを公開
gws mcp -s all                    # 全サービスを公開

公式ドキュメントによると、サービス1つあたり10〜80ツールが追加されます。クライアント側のツール上限（一般的に50〜100ツール）を超えないよう、必要なサービスのみに絞ることが推奨されています。

また、Google Cloud Model Armor【モデルアーマー】と連携することで、AIエージェントに届く前にAPIレスポンスをスキャンし、プロンプトインジェクション攻撃を検出・ブロックする機能も実装されています。

認証とセキュリティ設計

gwsは複数の認証フローに対応しており、ローカル開発・CI・サーバー環境のいずれでも利用できます。

• インタラクティブ認証（ローカル）: gws auth setupで Google Cloud プロジェクトの作成・API有効化・OAuthログインを一括設定。認証情報はAES-256-GCMで暗号化され、OSキーリングに保存されます。
• 複数アカウント管理: gws auth login --accountでメールアドレスごとに認証情報を分離して管理でき、デフォルトアカウントの切り替えも可能です。
• ヘッドレス/CI環境: インタラクティブ認証後にgws auth exportで認証情報をエクスポートし、CI環境に環境変数経由で渡す方法が公式に案内されています。
• サービスアカウント: サービスアカウントのキーファイルを環境変数で指定するだけで動作します。ドメイン全体の委任（Domain-Wide Delegation）にも対応しています。

認証の優先順位は、アクセストークン→認証情報ファイル→暗号化済みアカウント認証情報→プレーンテキストの順です。

開発者・エージェントにとっての実用的な意味

gwsが注目される理由は、「Googleが自ら提供するAPIドキュメント（Discovery Service）を読んでコマンドを構築する」というアーキテクチャにあります。これにより、次のような恩恵が生まれます。

• メンテナンスコストの削減: Google Workspace側のAPI変更に追従するための手動更新作業が不要になります。
• AIエージェントとの相性: 構造化JSONの出力とスキルファイルの組み合わせで、LLMがWorkspaceを操作するためのコードをゼロから書く必要がなくなります。
• Gemini CLI拡張機能: gemini extensions install https://github.com/googleworkspace/cliの一行で、Gemini CLIに全gwsコマンドとWorkspaceエージェントスキルを追加できます。

一方で、現時点ではv1.0未満であり、破壊的変更の可能性が明示されています。プロダクション環境への導入には注意が必要です。また、gws auth setup実行にgcloud CLIが必要であるなど、初期セットアップにある程度の手間がかかります。

よくある質問

Q: gwsはGoogleの公式ツールですか？

A: リポジトリはGoogleのgoogleworkspaceオーガニゼーション配下にありますが、公式ドキュメントには「これはGoogleが公式にサポートするプロダクトではない」と明記されています。利用には自己責任が伴います。

Q: OpenClaw以外のAIエージェントでも使えますか？

A: MCPサーバー機能を通じて、Claude Desktop・Gemini CLI・VS Codeなど、MCPプロトコルに対応した各種クライアントから利用できます。エージェントスキルも汎用のSKILL.md形式で提供されています。

Q: 無料で使えますか？

A: gwsツール自体はApache-2.0ライセンスのオープンソースソフトウェアです。ただし、各Google Workspace APIの利用にはGCP（Google Cloud Platform）プロジェクトが必要であり、APIの利用規模によって課金が発生する場合があります。

まとめ

Google Workspace CLI（gws）は、Discovery Serviceを使ったコマンド動的生成・構造化JSON出力・100以上のAIエージェントスキルという三つの特徴を持つ、Workspaceとのプログラマティックな連携を大幅に効率化するツールです。OpenClaw・Claude Desktop・Gemini CLIといったAIエージェントプラットフォームとの接続を念頭に設計されており、Workspace上のタスク自動化を検討する開発者やエンジニアにとって注目に値するプロジェクトといえます。v1.0に向けた活発な開発が続いているため、今後の動向を追い続ける価値があります。

【用語解説】

• MCP（Model Context Protocol）【エムシーピー】: AnthropicやGoogleらが推進する、AIエージェントが外部ツールと標準的にやり取りするためのオープンプロトコル。
• Discovery Service【ディスカバリーサービス】: GoogleがAPIの仕様（エンドポイント・パラメーター・スキーマ）をJSON形式で動的に配布する仕組み。gwsはこれをリアルタイム取得することでコマンドを自動構築します。
• Model Armor【モデルアーマー】: Google Cloudのセキュリティ機能。APIレスポンスに含まれる可能性のあるプロンプトインジェクション攻撃をAIエージェントに届く前に検出・ブロックします。

免責事項: 本記事の情報は執筆時点（2026年3月6日）のものです。AI技術は急速に進歩しているため、機能や制限は予告なく変更される場合があります。gwsはv1.0未満の開発中プロジェクトであり、破壊的変更が生じる可能性があります。

引用元:

• [1] googleworkspace/cli – GitHub – https://github.com/googleworkspace/cli
• [2] Google Workspace Developer Tools – developers.google.com – https://developers.google.com/workspace/guides/developer-tools
• [3] Google Workspace Updates Blog – workspaceupdates.googleblog.com – https://workspaceupdates.googleblog.com/