AIじゃないよ

Google Workspace CLI「gws」登場：Claude CodeやCodexからGmail・Drive・Calendarを直接操作する方法

当サイトはアフィリエイト広告を一部掲載しています。

2026年3月2日、Gmail、Google Drive、Calendarをはじめとする全Google Workspaceサービスをターミナルから操作できるCLIツール「gws」が公開された。わずか3日でGitHubスター数は7,100を突破している。

Googleアカウントの無料ユーザーでも利用可能であり、個人がCodexやClaude Code, AntigravityなどのAIエージェントツールと、Google Workspaceを容易に接続できる。

従来、Google Workspaceには統一的なCLIツールが存在せず、個々のサービスのAPIごとに個別のセットアップが必要だった。

「gws」は、それを一箇所に統合し、入出力もAIエージェントが使いやすい構造に最適化されているので、AIによる業務自動化を非常に容易に実装できるようになった。

これまで、Claude CodeやCodex、AntigravityなどのAIエージェントにGmailやGoogleドライブへのアクセス権を与えたくても、実装がいちいち面倒で結局手を出せずにいた。

「gws」の登場により、シェル上でのたった1行のコマンドだけで、Driveのファイル取得やGmailの検索ができる。

さらに、「gws」はMCPサーバーや100以上のAgent Skillsを内蔵しており、最初からAIエージェントに使われることを前提に設計されている。

本記事では、gwsの概要、AIエージェント連携の仕組み、インストール手順、そして利用上の注意点まで解説する。

gwsリポジトリ: https://github.com/googleworkspace/cli



gwsの概要：Google Workspaceをコマンド1行で操作する

gwsは、Google Workspaceの各サービスをターミナルのコマンドで操作するためのツールだ。

通常、GmailやGoogle Driveをプログラムから操作するには、Googleが提供するAPIを利用する。だが、サービスごとにクライアントライブラリを導入し、認証を設定し、コードを書く必要があり、ちょっとした自動化のためだけにかなりの準備が必要だった。

gwsを使えば、それが1行のコマンドに変わる。

# Driveのファイル一覧を取得
gws drive files list

# Gmailで未読メールを検索
gws gmail users.messages list --userId me --q "is:unread"

# Calendarの今日の予定を取得
gws calendar events list --calendarId primary --timeMin 2026-03-05T00:00:00Z

出力はすべて構造化されたJSON形式だ。

人間が目で確認するだけでなく、スクリプトを用いたデータ加工や、AIエージェントによる解析にもそのまま利用しやすい。

開発したのは、Google Workspace Developer Relationsチーム所属のJustin Poehnelt氏。gwsはAIエージェントに使われることを強く意識した設計であり、Vercel CEOのGuillermo Rauch氏も「2026 is the year of Skills & CLIs」とgwsを引用して評価している。

対応するGoogleサービス

gwsは、後述するDiscovery Service経由で、全てのGoogle Workspace APIをカバーしている。主なサービスは以下のとおりだ。

  • コア: Drive, Gmail, Calendar, Docs, Sheets, Slides, Forms, Keep, Tasks
  • コミュニケーション: Chat, Meet, People（Contacts）
  • 管理: Admin SDK（Reports, Directory）, Vault, Licensing
  • 開発: Apps Script, Events

gwsは無料アカウントでも利用可能

gwsを使うために、企業向けGoogle Workspaceの有料契約は必須ではない。

個人のGmailアカウント（無料）でも、Drive、Gmail、Calendar、Sheets、Docsといった主要サービスの操作は可能だ。実際、公式READMEのサンプルでも personal@gmail.com での利用例が掲載されている。

ただし、利用開始にはいくつかの準備が必要になる。

前提条件詳細
Googleアカウント無料のGmailアカウントで可。Google Workspace（有料）は不要
Google CloudプロジェクトOAuth認証情報の作成に必要。Google Cloud Consoleから無料で作成できる
gcloud CLI（任意）gws auth setupによる自動セットアップを使う場合のみ必要

Google Cloudプロジェクトの作成自体は無料であり、gwsが使うWorkspace APIも一般的な個人利用の範囲であれば課金は発生しない。つまり、Gmailアカウントさえ持っていれば、追加費用なしで試せる。

一方、Admin SDK（ユーザー管理やレポート取得）やVaultなど組織管理系のAPIは、Google Workspaceの有料プラン（Business Starter以上）の管理者権限が必要になる。自分がどのサービスを使いたいかによって、必要な契約レベルが変わる点は覚えておこう。

注意
gwsはGitHubのgoogleworkspaceオーガニゼーション配下で公開されているが、リポジトリには「This is not an officially supported Google product」と明記されている。Googleによる公式サポートやSLAは提供されていない。開発者のJustin Poehnelt氏はGoogle Workspace Developer Relationsチーム所属のDREだが、本ツールの位置づけは公式プロダクトではなくオープンソースプロジェクトである。

AIエージェントに「秘書業務」を任せる世界

コマンドの組み合わせで日常業務を自動化する

gwsの全コマンドはJSON出力に統一されているため、複数のコマンドをパイプやシェルスクリプトで組み合わせることで、サービスを横断した自動化が可能になる。

たとえば、朝の業務開始時に「今日の予定」と「未完了タスク」をまとめて確認するには、CalendarとTasksのコマンドを組み合わせればいい。

出力はJSONなので、フィルタリングしてSlackに投稿するスクリプトを書くことも、AIエージェントに渡して要約させることも容易だ。

会議の準備でも同様に、Calendarから次の会議の情報を取得し、Driveで関連ファイルを検索し、参加者情報をPeople APIから引くといった一連の流れを、すべてコマンドラインで完結できる。

AIエージェントが「Workspace担当の秘書」になる

gwsの真価は、AIエージェントと組み合わせたときに発揮される。

たとえばClaude Codeに「昨日届いたメールの中で、対応が必要なものをリストアップして」と頼めば、エージェントが gws gmail を使ってメールを取得し、内容を分析し、優先度付きの対応リストを返してくれる。

「来週の会議に必要な資料をDriveから探して」と言えば、Calendarから会議の議題を確認し、Driveを検索して関連ファイルを見つけ出す。

gwsのリポジトリには、こうしたエージェント向けの指示書（Agent Skills）が100以上同梱されている。中でもユニークなのが「ペルソナスキル」だ。

  • エグゼクティブアシスタント: メール対応、スケジュール管理、会議準備を一括で処理
  • IT管理者: ユーザーアカウント管理、セキュリティアラートの監視、Drive共有ポリシーの設定
  • プロジェクトマネージャー: 進捗レポートの生成、会議の設定、タスクの割り当て
  • セールスオペレーション: Sheetsの商談データからレポートを自動生成し、関係者にメール送信

AIエージェントに「役割」を与えるだけで、その役割に必要なWorkspaceの操作を一通りこなせるようになる仕組みだ。

企業での活用シナリオ

Gmail、Drive、Docs、Calendar、Sheets向けに50以上の「レシピ」（操作パターンの指示書）も用意されている。いくつか実用的なものを紹介しよう。

  • 障害対応の初動自動化: ポストモーテム用のGoogle Docsをテンプレートから作成し、振り返り会議をCalendarに設定し、エンジニアリングチームのChatスペースに通知する
  • 外部共有ファイルの監査: Driveで組織外に共有されているファイルを一括検出する。手作業で確認していた作業がコマンドの組み合わせに変わる
  • Sheetsからの一括メール送信: スプレッドシートの宛先リストを読み取り、各行のデータをもとにパーソナライズしたメールをGmailから送信する
  • オンボーディングの自動化: 新入社員用の共有ドライブ作成、チームフォルダへの権限付与、研修スケジュールのCalendar登録、ウェルカムメールの送信を一連の流れで実行する

従来であれば、こうした自動化にはGoogle Apps Scriptを書くか、各APIのクライアントライブラリを個別に導入してコードを書く必要があった。gwsなら、シェルスクリプトやAIエージェントへの指示だけで実現できる。

AIエージェント連携：Agent Skills、MCP、Gemini CLI

gwsは、AIエージェントから利用されることを強く意識して設計されている。すべてのコマンド出力が構造化JSON、--helpによる自己文書化、schemaコマンドによるAPI仕様の参照といった特徴は、いずれもLLMが扱いやすい形式だ。

エージェントとの接続方法は3つ用意されている。

Agent Skills：エージェント向けの指示書

Agent Skillsは、AIエージェントにgwsの使い方を教えるための指示書（SKILL.mdファイル）だ。Claude CodeやGemini CLIなどのエージェントがこのファイルを読み込むことで、Workspace操作の方法を理解して実行できるようになる。

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

# サービスごとに個別インストール
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

MCPサーバー：Claude DesktopやVS Codeから直接呼び出す

gwsはModel Context Protocol（MCP）サーバーとしても動作する。Claude Desktop、VS Code、Gemini CLIなど、MCP対応のクライアントからGoogle Workspace APIをツールとして呼び出せる。

# DriveのみMCPツールとして公開
gws mcp -s drive

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

MCPクライアント側の設定例（Claude Desktop等）は以下のとおりだ。

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

ただし、各サービスは10〜80程度のツールを生成する。クライアント側のツール上限（通常50〜100）を超えないよう、必要なサービスだけを指定するのが実用的だ。

Gemini CLI拡張

Gemini CLIを利用している場合は、gwsをエクステンションとしてインストールするだけで、GeminiエージェントがWorkspace操作を直接実行できるようになる。

gws auth setup
gemini extensions install https://github.com/googleworkspace/cli

CLIとMCPサーバー、どちらを選ぶべきか

gwsがMCPサーバーを内蔵しつつも、CLIとしての利用を第一に設計されているのには理由がある。

CLIツールとMCPサーバーではトークン効率に大きな差がある。

ある分析記事では、同等のタスクにおいてCLIがMCPの約35分の1のトークン消費量で済むケースが報告されている。MCPサーバーはツール定義全体をコンテキストウィンドウに読み込む必要があるのに対し、CLIコマンドはLLMの事前学習知識を活用できるためだ。

とはいえ、MCPにも利点はある。

Claudeの通常のデスクトップアプリやChatGPTのような非エンジニア向けのGUI環境では、CLIを直接実行する手段がないため、MCPサーバー経由が唯一の接続方法となる。用途に応じて使い分けるのがよいだろう。

コマンドを毎回Googleから取り寄せるDiscovery Service方式

gwsの技術的な最大の特徴は、使えるコマンドの一覧をツール自身の中に持っていないことだ。

一般的なCLIツールは、開発者がリリース時にコマンド体系を確定させる。新しいAPIに対応するにはツール自体のアップデートが必要だ。

gwsはまったく違うアプローチをとる。実行するたびにGoogleが公開している「APIの仕様書」（Discovery Service）を取りに行き、そこに記載された内容からコマンドを動的に生成する。

つまり、GoogleがWorkspace APIに新しい機能を追加すれば、gws側のアップデートなしで自動的に対応する。

具体的な処理の流れは以下のとおりだ。

  1. ユーザーが gws drive files list のように実行する
  2. gwsが drive という指定からGoogle Driveサービスを特定する
  3. Google DriveのAPI仕様書（Discovery Document）を取得する（24時間キャッシュ）
  4. 仕様書の内容から、使えるコマンドの一覧を動的に生成する
  5. 残りの引数を解釈し、認証・リクエスト送信を行う
  6. 結果をJSON形式で出力する

gwsはRustで書かれており、単一バイナリにコンパイルされるため起動が速い。Discovery Documentのキャッシュがある状態では、コマンドの応答は十分に高速だ。

インストールと認証のセットアップ

インストール方法

最も手軽なのはnpmによるインストールだ。npmパッケージにはOS・アーキテクチャ別のネイティブバイナリが同梱されているため、Rustのツールチェーンは不要である。

npm install -g @googleworkspace/cli

Node.jsを使わない場合は、GitHub ReleasesからOS別のバイナリを直接ダウンロードすることもできる。

認証セットアップ

gwsの利用にはOAuth認証が必要だ。認証方法は4つあるが、最も簡単なのはgws auth setupコマンドによる自動セットアップである。

# gcloud CLIがインストール済みの場合（最速）
gws auth setup     # GCPプロジェクト作成・API有効化・ログインを自動実行
gws auth login     # 以降のログイン

gws auth setupは内部的にgcloud CLIを呼び出してGCPプロジェクトの作成やAPI有効化を行う。そのため、事前にgcloud CLIがインストールされている必要がある。

gcloudを持っていない場合は、Google Cloud Consoleで手動セットアップする。

  1. Google Cloud Consoleでプロジェクトを作成する
  2. OAuth同意画面を設定する（アプリタイプ: External、テストモードで可）
  3. 「テストユーザー」に自分のGoogleアカウントを追加する
  4. OAuth認証情報を作成する（タイプ: デスクトップアプリ）
  5. ダウンロードしたJSONを ~/.config/gws/client_secret.json に配置する
  6. gws auth login を実行する

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

注意
OAuthアプリが未検証（テストモード）の場合、Googleはスコープ数を約25に制限する。gwsのrecommendedスコーププリセットには85以上のスコープが含まれており、テストモードではエラーになる。必要なサービスだけをスコープに指定すること。 
gws auth login --scopes drive,gmail,calendar

その他の認証方法として、環境変数 GOOGLE_WORKSPACE_CLI_TOKEN によるアクセストークン直接指定や、GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE によるサービスアカウント認証にも対応している。CI/CDパイプラインやヘッドレス環境でも利用可能だ。

利用上の注意点と現時点での課題

gwsは魅力的なツールだが、2026年3月時点ではv0.4.4というアーリーステージにある。利用にあたっていくつかの注意点を把握しておくべきだ。

  • 破壊的変更の可能性: v1.0に向けて破壊的変更が予告されている。3日間でv0.2.2からv0.4.4まで急ピッチで更新されており、APIの安定性は保証されていない
  • OAuthセットアップの複雑さ: Hacker Newsでは「45分かけてもセットアップが完了しなかった」という報告がある。特にテストモードの25スコープ制限と、gwsのrecommendedプリセットが85以上のスコープを要求する矛盾が混乱を招いている
  • 公式サポートなし: googleworkspace org配下にあるにもかかわらず、Googleによる公式サポートは存在しない。企業環境での本番利用には慎重な判断が必要だ
  • ドキュメントの不足: Discovery Serviceから動的生成されるコマンドの詳細なドキュメントが存在しないため、gws schemaコマンドや--helpフラグで自力で調べる必要がある

AIエージェントにWorkspaceを任せる時代の入口

gwsは、Google WorkspaceをプログラムやAIエージェントから操作したい人にとって、待望のツールだ。

個人開発者ならDriveやGmailの操作をシェルスクリプトで自動化できる。AIエージェントを構築しているエンジニアなら、MCPサーバーやAgent Skillsを活用してLLMにWorkspace操作能力を付与できる。Workspace管理者なら、Admin SDKへのCLIアクセスでレポート取得やユーザー管理を効率化できる。

v1.0前のアーリーステージであること、公式サポートがないこと、OAuthセットアップにGCPの知識が必要であることは念頭に置く必要がある。だが、AIエージェントがメール・カレンダー・ドキュメントを横断的に操作できる世界は、すでに手の届くところにある。

まずは個人のGoogleアカウントで、Driveのファイル一覧取得あたりから試してみるのがよいだろう。

筆者プロフィール画像

この記事を書いた人 kumori

AIツール／アプリ／ガジェットを実際に検証し、具体のユースケースまで噛み砕いて解説しています。

  • 米国の大学院で統計学（修士）
  • Python・Rによるデータ分析
  • マーケティング／広告運用（TV〜Web、数十億規模PJのリード経験）

X Profile Contact



Make a comment

*
*
* (公開されません)