Google Workspace 公式CLIが出た。gogcli は引退か？

2026年3月3日、Googleが公式の Workspace CLI gws をリリースした。

https://github.com/googleworkspace/cli

自分はこれまで gogcli（gog コマンド）を使って、Claude CodeからGoogle Workspace（スプレッドシート、Gmail、Drive、カレンダー）を操作していた。公式が出たなら乗り換えるべきか？ 調べてみた。

gws の概要

gws（Google Workspace CLI） は、Google公式のコマンドラインツール。キャッチコピーは：

One CLI for all of Google Workspace — built for humans and AI agents

対応サービスは Drive、Gmail、Calendar、Sheets、Docs、Chat など、ほぼ全ての Google Workspace API。

特徴

• 動的コマンド生成: Google Discovery Service からAPIを実行時に読み込み、コマンドを動的に構築する。新APIが追加されると自動で対応
• タブ補完 / --help / --dry-run
• MCP サーバー内蔵: Claude Desktop や Claude Code から直接使える
• 構造化JSON出力: LLMとの連携を想定した設計

インストール

npm install -g @googleworkspace/cli

Rustでビルドも可能：

cargo install --path .

コマンド例

# Driveのファイル一覧
gws drive files list --params '{"pageSize": 10}'

# スプレッドシート作成
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

# APIスキーマ確認
gws schema drive.files.list

MCP サーバー機能

これが一番面白い。gws 自体が MCP サーバーとして動作する。

起動

gws mcp -s drive                    # Driveだけ
gws mcp -s drive,gmail,calendar     # 複数サービス
gws mcp -s all                      # 全部（ツール数に注意）

サービスごとに10〜80個のツールが登録されるので、全部入れるとツール上限（50〜100）を超える場合がある。必要なサービスだけ指定するのが推奨。

Claude Desktop との連携

{
  "mcpServers": {
    "gws": {
      "command": "gws",
      "args": ["mcp", "-s", "drive,gmail,calendar"]
    }
  }
}

認証

# インタラクティブ（デスクトップ環境）
gws auth setup        # GCPプロジェクト設定 + OAuthログイン
gws auth login        # 再ログイン

# ヘッドレス / CI環境
gws auth export --unmasked > credentials.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json

# サービスアカウント
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
export GOOGLE_WORKSPACE_CLI_IMPERSONATED_USER=admin@example.com

認証情報はAES-256-GCMで暗号化し、OSキーリングに保存される。

gogcli との比較

これまで使ってきた gogcli（steipete氏作のOSS）との比較。

gws の強み

1. MCP内蔵: スキルを書かなくても、MCPサーバーとして登録するだけでClaude Codeから使える
2. API網羅性: Discovery Serviceから動的生成するので、新APIも自動で使える
3. 公式サポート: 長期的な安定性が期待できる

gog の強み（まだ捨てられない理由）

1. コマンドが短い: gog sheets get ID 'A1:Z100' vs gws sheets spreadsheets.values get --params '...'
2. 安定してる: 今のワークフローが壊れない。gws は v0.2 でbreaking changesが予告されてる
3. スキルで使い方を教えてある: Claude Codeが gog の使い方を熟知してるので、ミスが少ない

現時点での判断

すぐに乗り換える必要はない。

gws はまだ v0.2。v1.0 に向けて breaking changes が入ると明言されている。今のワークフローが gog で問題なく動いている以上、急いで移行する理由がない。

ただ、MCP対応は大きい。gog はBash経由で呼び出しているが、gws なら MCP で直接つながる。スキルを書く手間もなくなる。

移行タイミングの目安:

• gws が v1.0 に達したとき
• Claude Code の MCP 対応がさらに進んだとき
• gog のメンテが面倒になったとき

それまでは gog を使い続けて、gws の動向をウォッチする。

まとめ