toolin.ai logo
toolin.ai

Google Workspace CLI：AI Agent を1コマンドでメール・ドライブ・カレンダーまで統括させる

·Toolin 編集部

Star3万近くを獲得したオープンソースCLIが、Gmail、Drive、Calendar、Sheetsを統一インターフェースにラップ。100以上のAgent Skillsを内蔵し、人間にもAIにも使える

Google Workspace CLI：AI Agent を1コマンドでメール・ドライブ・カレンダーまで統括させる
Google Workspace CLI とは中核機能全 Workspace 製品の統一ラップ2フェーズ解析アーキテクチャ100以上の Agent Skills を内蔵人間にやさしい作り使い方インストールと認証AI Agent と組み合わせる典型的なワークフロー例あの「解雇」騒動応用シーンプロジェクト情報
AI製品

Google Workspaceの各サービスAPIはずっと分断されたままでした。メール、ドライブ、カレンダー、スプレッドシートを呼ぶには、それぞれインターフェースと接続し、個別に認可を設定する必要がありました。AI Agentがそこら中で走り回る2026年において、AgentにGmail、Calendar、Driveを操作させる手軽な道具が逆にない——Google Workspace CLIが解決しようとしているのはまさにこの問題です。全製品のAPIを統一されたコマンドラインにラップし、すべての返却データを標準JSONで出力し、AIエージェント向けのAgent Skillsを100以上内蔵しています。このプロジェクトはGitHubで3万Star近くを獲得しましたが、その中心開発者Justin Poehneltは、このプロジェクトが原因でGoogleに解雇されました。本記事では、このツールが何をし、どう使うかに加え、その騒動についても簡単に触れます。

Google Workspace CLI とは

一言で定義すると：Google Workspace APIを、人間にもAI Agentにも呼びやすい統一インターフェースに変えるものです。

  • 人間にとって：RESTドキュメントを見ながらcurlリクエストを手書きする必要がなくなり、すべてのリソースに --help が用意され、--dry-run でリクエストをプレビューでき、ページネーションも自動処理
  • AIエージェントにとって：すべての返却結果が構造化JSONで、内蔵のAgent Skillsと組み合わせれば、LLMは追加ツールを書かずにWorkspaceを直接管理できる

Image

プロジェクトは github.com/googleworkspace/cli、執筆時点でStar数は3万近く。

中核機能

全 Workspace 製品の統一ラップ

Gmail、Drive、Calendar、Sheets、Chat、Adminという全製品のAPIが、同型のコマンドラインサブコマンドへラップされています。1コマンドで1系統の操作が完結し、ドキュメントを何度も引き直す手間が省けます。

2フェーズ解析アーキテクチャ

CLIはtwo-phase parsing戦略を採り、性能と動的性を両立しています。

  1. argv を読み取り、呼び出すサービス（例：drive）を特定
  2. そのサービスのDiscovery Document（API発見ドキュメント）を取得し、24時間キャッシュ
  3. ドキュメントで定義されたresourcesとmethodsに基づき、clap::Command のコマンドツリーを動的に構築
  4. 残りのコマンドライン引数を再解析
  5. 認証を完了し、HTTPリクエストを構築して実行

すべての出力（成功結果、エラーメッセージ、ダウンロードのメタデータ）が構造化JSONで返るため、プログラムにもLLMにも解析しやすい作りです。

100以上の Agent Skills を内蔵

これがAI Agent向けの最も重要な能力です。

  • 対応する各APIに1つのSkill（SKILL.md ファイル形式で提供）
  • さらに一般的なワークフロー向けの高レベルな補助スキルも同梱
  • Gmail、Drive、Docs、Calendar、Sheetsなどをカバーする厳選50例の使用例を提供

Image

完全なAgent Skillsリスト。各APIに1つのSKILL.mdが対応し、組み合わせればLLMがアプリ横断タスクをこなせる。

人間にやさしい作り

  • --help のヘルプがすべてのリソースをカバー
  • --dry-run でこれから発行されるリクエストをプレビューでき、デバッグに便利
  • ページネーションを自動処理し、pageTokenの手動結合が不要
  • 認証フローは統一され、OAuthとService Accountに対応

使い方

インストールと認証

# Homebrew でインストール（macOS）
brew install googleworkspace/tap/cli

# または GitHub Releases からプリコンパイル済みバイナリをダウンロード
# https://github.com/googleworkspace/cli/releases

# 初回実行時に OAuth 認可がガイドされる
gws-cli gmail messages list --query "is:unread"

AI Agent と組み合わせる

プロジェクト内の SKILL.md ファイルをあなたのAgentのツールディレクトリにマウントすれば、Agentが対応スキルを自動呼び出しできます。たとえばCodex / Claude Codeに「先週の添付付き未読メールをすべて探してローカルにダウンロードして」と頼むと、Agentは gmail.messages.list → gmail.messages.get → gmail.attachments.get というコマンド列を自動で選びます。

典型的なワークフロー例

シナリオコマンドの組み合わせ
未読メールを一覧gws-cli gmail messages list --query "is:unread"
Driveへファイルアップロードgws-cli drive files upload --path ./report.pdf
今日のカレンダーを確認gws-cli calendar events list --time-min "today"
Sheetのデータを読むgws-cli sheets values get --range "A1:D100"

あの「解雇」騒動

ツール自体はほぼすべての点で正しいことをやりました。公開されるやHacker Newsの1位に躍り出し、Google内部からディレクターや幹部が行列を作って教えを請いに来たほどです。ところが話は「内部イノベーションが会社に増幅される」という筋書きにはなりませんでした。

  • 中心コントリビュータのJustin Poehnelt（GitHubでコミット数1位、24 commits）は、このプロジェクトが原因で解雇されたと明かした
  • 直接の引き金は、法務が「なぜプロジェクトのGitHubリポジトリにGoogleのロゴとブランドカラーが出ているのか」と繰り返し追及したこと
  • より皮肉なタイムライン：彼が解雇される2日前、Google Cloud Nextが公式版Workspace CLIの提供開始を発表したばかりで、その要件と実装の発想は彼が趣味で作ったツールと高度に重なっていた
  • 彼のために怒りをあらわにした「OpenClawの父」は公にこう叫んだ。「GoogleはあのGoogle Workspace CLIを作った男を首にした。理由はまさに、彼がそのプロジェクトを作ったからだ。幸い、Googleは私を首にできない。」そしてPoehneltをCodexチームに招いた

💡 ヒント：利用者にとって、あの騒動はツール自体の価値を損ないません。ただし注意が必要です——Googleはすでに公式版の同種ツールGWSをリリースしており、今後このオープンソースプロジェクトが内部リソースを継続的に得られるかは不透明です。企業利用の前に、両ルートの安定性を評価するのをおすすめします。

応用シーン

  • AI Agentによるオフィス自動化：Codex / Claude CodeのようなAgentにあなたのGmail、Calendar、Driveを直接管理させる
  • 一括データ移行とバックアップ：アカウントをまたいだメール同期、Driveファイルのアーカイブ
  • 運用とコンプライアンス監査：Adminディレクトリの一括照会、コンプライアンスレポートのエクスポート
  • 個人開発者の効率化ツール：散在するWorkspace操作をスクリプト化し、curlの手書きに別れを告げる

プロジェクト情報

  • GitHub：https://github.com/googleworkspace/cli
  • Star数：3万近く（2026年6月時点）
  • 言語：Rust（clap::Command ベース）
  • ライセンス：リポジトリのLICENSEファイルを参照
  • 公式の代替品：Google Cloudがリリースした公式版GWS（機能の重なりが大きい）
すべての記事