[AI書房] 第19章 Google WorkspaceCLI方式: Googleサービスを一括管理
Claude Code完全攻略
第5部
第19章 Google WorkspaceCLI方式: Googleサービスを一括管理
金京鎮
GWS コマンドライン方式とは何か
YouTube の動画を基にリソースガイド文書を作成しなければならない状況を想像してみましょう。従来の方法では、以下の手順を踏みます。API を呼び出して Google Docs を生成し、マークダウンテキストを挿入します。しかし、結果を確認すると、書式が失われた生のマークダウンがそのまま表示されます。ヘッダーもなく、リンクも機能せず、画像も含まれていません。
GWS コマンドライン方式(Google Workspace コマンドライン方式、Google Workspace CLI)を使用すれば、状況は全く異なります。YouTube 動画のリンクを Claude Code に貼り付け、「リソースガイドを作成してください」と指示するだけです。
エージェントは動画のトランスクリプトをダウンロードし、Google Docs を生成しますが、API 呼び出しではなく、ターミナルコマンド(bash コマンド)を通じて Google と直接対話します。完成した文書にはヘッダー画像が挿入され、YouTube チャンネルへ戻るリンクが機能し、市場分析の内容が体系的に整理されており、下部には CTA(Call to Action)も含まれています。
コマンドライン方式と画面ベース方式の違い
ここで「コマンドライン方式」という用語を解説しましょう。コマンドライン方式は、コマンドラインインターフェース(Command Line Interface)の略称です。私たちが日常的に利用しているのは、画面ベースの方式(Graphical User Interface、グラフィカルユーザーインターフェース)です。ボタンをクリックし、フォームに入力し、メニューを操作する方式です。一方、コマンドライン方式はテキストによる命令でコンピュータと対話します。
AI エージェントにとってコマンドライン方式が有利な理由は明白です。エージェントはボタンをクリックできませんが、テキスト命令は自由に記述できます。GWS コマンドライン方式はこの特性を活用し、Google Workspace のすべてのサービスをテキスト命令で制御可能にします。
一つのツール、六つのサービス
GWS コマンドライン方式一つでアクセス可能な Google サービスは以下の通りです。
これらすべてが一つのコマンドライン方式ツールに統合されています。個別の API エンドポイントを探す必要も、MCP 設定をサービスごとに繰り返す必要もありません。Google Workspace が新しい API エンドポイントやメソッドを追加しても、GWS コマンドライン方式は自動的に検出します(Auto Discovery)。メンテナンスがほぼ不要であることを意味します。
[図 19-1] GWS コマンドライン方式で接続する Google Workspace サービスの構成図
オープンソース、および注意事項
GWS コマンドライン方式は、GitHub に公開されているオープンソースプロジェクトです。無料で利用できます。ただし、一つ知っておくべき点があります。GitHub のページには次のような文言が記載されています。
これは公式サポート製品ではないという意味です。安全ではないという意味ではありません。実際の Google 製品ですが、現在はオープンソースのベータ状態です。開発者実験室に近い位置づけと捉えてください。続く文言もあります。
活発に開発中で、1.0 バージョンに向けて進む過程で互換性が損なわれる変更がある可能性があるという案内です。現在の状態でも十分に実用的であり、今後さらに向上するという意味でもあります。
インストールと認証:Google Cloud プロジェクトから OAuth まで
GWS コマンドライン方式のインストール手順は、Claude Code のサポートがあればスムーズに進みます。ただし、いくつかの手動ステップが必要となるため、全体の流れを順を追ってご説明いたします。
ステップ 1:Claude Code へのインストール依頼
GitHub リポジトリのリンクをコピーし、Claude Code に以下のように伝えてください。
エージェントはリポジトリのドキュメントを解析し、既にインストールされている前提条件(prerequisites)を確認した上で、コマンドライン方式そのものをインストールします。この段階までは自動的に処理されます。
2 段階目:Google Cloud プロジェクトの作成
[Google Cloud Console](https://console.cloud.google.com) にアクセスし、右上で正しいアカウントでログインされているか確認してください。
新しいプロジェクトを作成します。名前は自由に設定できます。「Claude-Code-GWS」のような名前にすると、後で識別しやすくなります。プロジェクト作成後、該当プロジェクトを選択して有効化してください。
3 段階目:OAuth 同意画面の設定
上部の検索窓に「APIs and services」と入力し、OAuth 同意画面の設定画面へ移動してください。
4 段階:OAuth クライアント ID の作成
「APIs and services」>「Credentials」へ移動し、「Create Credentials」>「OAuth Client ID」を選択してください。
クライアント ID とクライアントシークレットが生成されます。これを JSON ファイルとしてダウンロードし、GWS のグローバル設定パス(例:~/.config/gws/)に保存してください。パスが不明な場合は、Claude Code に「フルパスを教えてください」とお尋ねください。
[図 19-2] Google Cloud Console における OAuth クライアント ID 作成画面
5 段階:API の有効化
Google Cloud プロジェクトでは、利用したい各サービスの API を個別に有効化する必要があります。Gmail API、Google Drive API、Google Sheets API、Google Slides API、Google Calendar API などを一つずつ開き、「Enable」ボタンをクリックします。
6 ステップ:認証ログイン
Claude Code に「gws auth login」コマンドを実行するよう依頼してください。ブラウザのタブが開いたら、使用する Google アカウントを選択し、要求された権限を確認した上で「Allow」をクリックします。
認証が完了すると、Claude Code が自動的に接続を検証します。「2025 年 4 月に作成した Google ドキュメントを検索してください」のような簡単な指示で、正常に動作しているか確認できます。
インストール中に問題が発生しても慌てないでください。Claude Code に「動作しないのですが、このようなエラーが表示されています」と伝えれば、ドキュメントを再参照しながら解決方法を案内してくれます。数回のやり取りでほとんどの問題は解決します。
Gmail の優先度による自動分類
GWS のコマンドライン方式がインストールされましたので、実用的なワークフローを作成しましょう。最初のステップは、Gmail のメールを優先度に基づいて自動分類することです。
要件の提示
この指示で注目すべき点は、「私のビジネスと優先度に関する知識に基づいて」という部分です。Claude Code は、claude.md ファイルや過去の会話で蓄積された文脈情報を活用して判断を行います。
実行結果
エージェントは30件の未読メールを取得し、各メールにビジネス関連性に基づいて優先度スコアを付与します。ニュースレターの購読メールは低スコア、クライアントからの問い合わせやパートナーシップの提案は高スコアとなります。
[図19-3] 30件のメールに優先度スコアを付与した結果の画面
スコアが5点未満のメールは自動的に未読扱いとなります。朝出社してこのワークフローを一度実行すれば、受信トレイには実際に確認が必要なメールのみが残ります。30件のメールを一つずつ開いて重要度を判断する時間が節約されます。
Google スライドの自動生成と視覚的検証ループ
Gmailの分類がテキストベースの作業であるのに対し、Google スライドの生成は視覚的要素が関与するより複雑な作業です。ここではエージェントの作業フローにおける興味深い限界とその克服方法が明らかになります。
最初の試み:プログラムによる作成
ブランドガイドラインとロゴを提供し、スライドデッキの作成を依頼します。結果は「まあまあ」のレベルですが、間隔がずれたり、テキストが重なったりする箇所があります。
エージェントに「この部分を修正してください」と伝えると、返ってくる回答は示唆に富んでいます。
エージェントはGoogleスライドのAPIを通じて、座標、サイズ、色などを数値で指定してスライドを作成します。しかし、その結果を目で確認することはできません。まるで目を閉じて絵を描くようなものです。
視覚的検証ループの構築
この問題の解決策は、エージェントに「目」を与えることです。Chrome DevToolsへのアクセス権限を付与すれば、エージェントがスライドをブラウザで開き、スクリーンショットを撮影し、その画像を分析できるようになります。
このプロセスを「ビジュアル検証ループ」と呼びます。その仕組みは以下の通りです。
[図19-4] ビジュアル検証ループの動作フロー
検証ループ適用後の結果
ビジュアル検証ループを適用してスライドを再生成すると、結果が劇的に改善されます。ブランドカラーが一貫して適用され、ロゴが右上に配置され、カスタム画像がブランドカラーと調和します。最後のスライドにはCTAも含まれています。
エージェントは各スライドを順に巡回し、スクリーンショットを撮影して、間隔、配置、テキストの可読性を分析します。最後のスライドの下部間隔が異常であれば、これを検知して修正します。
完璧ではありません。Gamma などの専門的なプレゼンテーションツールのレベルにはまだ及びませんが、無料で、自動化可能であり、繰り返し使用するほどに改善されます。エージェントに「スライドデッキを再点検し、今後どのように改善できるか教えてください」と依頼すると、エージェントは各スライドを再度スクリーンショットとしてキャプチャし、改善策を整理します。
一つ、実用的なコツがあります。スクリーンショットを撮影する際、ブラウザウィンドウのサイズが小さいと解像度が低下し、分析の質が落ちます。プレゼンテーションモードでスクリーンショットを撮影する方が、より正確な結果を得られます。
同じ視覚的検証ループを、Google ドキュメントの生成にも適用できます。文書の書式、画像の位置、リンクの動作を自動的に確認するのです。
100 以上の内蔵スキルレシピの活用
GWS コマンドライン方式の強みの一つに、スキルレシピがあります。100 種類以上の事前構築済み多段階ワークフローパターンが内蔵されています。
レシピの種類
GitHub リポジトリの Skills セクションで一覧を確認できます。いくつか例をご紹介しましょう。
これらのレシピは、別途インストールすることなく、GWS コマンドライン方式がインストールされた環境ですぐにご利用いただけます。エージェントがリクエストの性質を把握し、適切なレシピを自動的に選択します。
JSON 優先設計の利点
GWS コマンドライン方式の応答は JSON 形式で構造化されています。これがなぜ重要なのかを説明しましょう。AI エージェントは、構造化データを非構造化テキストよりもはるかに正確に処理できます。API 応答が JSON で返される場合、エージェントは必要な情報を正確に抽出し、次のステップに引き渡すことができます。パースエラーが減少し、ワークフローの信頼性が向上します。
コンテキスト効率性
MCP 接続サーバーをサービスごとに個別に接続すると、それぞれがコンテキストを消費します。Gmail MCP、Drive MCP、Calendar MCP をそれぞれ設定すると、設定情報だけでかなりのコンテキストが使用されてしまいます。GWS コマンドライン方式は単一のツールであるため、コンテキストの消費を最小限に抑えることができます。この違いは、複雑なワークフローにおいて体感されます。
[図 19-5] GWS コマンドライン方式の GitHub ページにおけるスキルレシピ一覧のキャプチャ
現在の限界と展望
コミュニティの反応は二分されています。Twitter では「驚くほど強力」という評価と「やや不安定」という評価が共存しています。一部のユーザーは、認証を複数回繰り返す必要がある現象を報告しています。
実際の使用経験では、検索、表示、予約といった基本機能はほぼ完璧に動作します。スライド作成のように視覚的な精密さが求められる作業では、まだ改善の余地があります。しかし、まだバージョン1.0 に到達していない製品であることを考慮すれば、今すぐインストールして使い慣らすことが賢明な選択です。
一つのコマンドラインツールでグーグルの主要サービスをすべて制御できることは、エージェントの行動範囲がそれだけ広がったことを意味します。メールの分類、スライドの作成、カレンダーの管理がすべて自然言語の一行で可能になります。このツールをYouTubeのデータ分析と組み合わせると、どのようなワークフローが構築されるか見ていきましょう。




