• #Google Workspace
  • #CLI
  • #gws
  • #gogcli
  • #開発ツール
開発tax-assistantメモ

Google Workspace CLI (gws) 公式リリースとgogcli比較

2026年3月3日、Googleが公式のWorkspace CLI gws をリリースした。ターミナルからGmail、Drive、Calendar等を操作できるツールで、GitHubリポジトリは googleworkspace/cli にある。

自分はこれまで steipete/gogcli を使ってきた。steipete氏（Peter Steinberger）が開発しているOSSで、Google系サービスをCLIから叩ける。今回Google公式が出たので、両者を並べて整理する。

gws の概要

Google Workspace チームが公式に開発・メンテナンスするCLI。

  • リポジトリ: https://github.com/googleworkspace/cli
  • リリース日: 2026-03-03
  • 対応サービス: Gmail, Drive, Calendar, Docs, Sheets 等
  • 認証: OAuth 2.0 / サービスアカウント
  • 特徴: Google API を直接ラップしており、API の全機能にアクセスできる
# インストール（例）
go install github.com/googleworkspace/cli/cmd/gws@latest

# Gmail の未読メール一覧
gws gmail messages list --query "is:unread" --max-results 10

# Drive からファイルダウンロード
gws drive files download --file-id <ID> --output ./downloaded.pdf

公式なので、Google API がバージョンアップしても同時にCLI側も追従する。新しい API エンドポイントが追加されたとき、最初にサポートされるのはこちらだろう。

gogcli の概要

steipete氏が開発するOSSのGoogle関連CLI。自作ツールではなく、コミュニティで開発されているライブラリ。

  • リポジトリ: https://github.com/steipete/gogcli
  • 開発者: Peter Steinberger（steipete）
  • 特徴: シンプルなインターフェース、Claude Code等のAIツールとの連携を意識した設計
# メール検索
gogcli gmail search "from:[email protected] subject:invoice"

# カレンダー予定の取得
gogcli calendar list --days 7

AIエージェントが呼び出しやすいコマンド体系になっている点が、公式ツールとの差別化ポイント。

比較表

観点gws（Google公式）gogcli（steipete氏OSS）
メンテナンスGoogle Workspace チーム個人開発者 + コミュニティ
API追従最速。公式なので当然API変更時にラグが生じうる
認証OAuth 2.0 / サービスアカウントOAuth 2.0
出力形式JSON / テーブルJSON / 人間向けテキスト
AI連携汎用的AIエージェントとの連携を意識
ドキュメント公式ドキュメント充実README + 実例ベース
成熟度リリース直後（2026-03-03）先行して運用実績あり
ライセンスApache 2.0MIT

現時点での使い分け

gws を選ぶ場面

  • Google API の全機能を使いたいとき
  • サービスアカウント認証が必要なとき（組織管理系の操作）
  • 長期的なメンテナンス保証が欲しいとき

gogcli を続ける場面

  • Claude Code のツールチェインに組み込んでいて、切り替えコストが見合わないとき
  • AI エージェントから呼びやすいコマンド体系を重視するとき
  • 今の運用で困っていないとき

移行の判断

手が止まった。gogcli で不満があるわけではない。メールの検索もカレンダーの取得も、今のワークフローで回っている。

ただ、公式ツールが出た以上、API追従の確実性は gws に軍配が上がる。Google が認証フローを変えたり、API のバージョンを切ったりしたとき、公式は壊れない。OSSは壊れうる。

当面の方針: gogcli を使い続けつつ、gws を手元にインストールして並行で試す。gogcli で API エラーが出始めたら、そのタイミングで移行する。

振り返り

Google が公式 CLI を出してきた。ターミナルからの Workspace 操作を、Google 自身が「サポートする」と宣言した形になる。AI エージェントが API を叩く場面が増え、GUI よりも CLI のほうが自動化に組み込みやすいことに、Google も気づいたのだろう。

steipete 氏の gogcli は、公式が存在しない時期に穴を埋めた。公式が出たからといって gogcli の価値が消えるわけではなく、AI エージェントが直接呼びやすいコマンド設計は引き続き参考になる。