Google Workspace CLI ＋ Antigravity エディタ｜社内・学内・仕事で使う「何ができるか」と実例（設定・ログイン・メール→スライド・進捗まとめ配信）

GWS とは・でできること

Google Workspace（GWS）はビジネス向けのコラボ・生産性スイートです。Gmail、Drive、Meet、Calendar、Chat、Gemini、Docs、Sheets、Slides、Tasks などが含まれ、独自ドメイン・増量ストレージ・24時間サポートなどが特徴です。
2025年1月以降、Business/Enterprise では AI（Gemini）がサブスクに含まれます。エディション（Starter / Standard / Plus / Enterprise）で機能差があり、詳細は調査メモ セクション2や公式サイトを参照してください。
「Workspace を契約しないと使えない」わけではなく、Gmail・Drive などは個人アカウントから API で利用できる場合もある一方、Chat などは組織の GWS 契約がないと使えない機能があります。

GWS と Google Cloud の違い・gws の前提

Google Cloud は IaaS/PaaS（インフラ・開発基盤）、GWS は SaaS（完成された業務アプリ）です。gws は Workspace の API を叩く CLI で、認証・プロジェクトは GCP 側（プロジェクト作成、OAuth クライアント、API 有効化）が前提です。
gws auth setup は gcloud または GCP コンソールで用意した情報を使います。入門手順はgws 入門（インストール〜認証〜Drive/Gmail）を参照してください。

料金の要点

日本円は税抜です。Business Starter/Standard/Plus のフレキシブル月額（例: ¥950 / ¥1,900 / ¥3,000）と年間プラン（月額換算でお得）があります。AI 機能は 2025年1月以降、サブスクに含まれ追加料金なし。Enterprise は要問い合わせ。最新は公式料金で確認してください。

Google One AI Pro と GWS の整理

Google One AI Pro は個人向け、GWS は組織向けです。Workspace アカウントでは Google One AI Pro には申し込めません。GWS 契約時の AI は Workspace のエディションで決まり、「AI Pro を契約したから GWS で何か増える」関係ではありません。個人向けプランについてはGoogle One プラン一覧と AI Pro/Ultra 契約内容を参照してください。

GWSCLI（gws）の位置づけと注記

gws は Workspace 各種 API を一つの CLI で操作し、Discovery Service でコマンドを動的構築します。Google 公式の正式なアプリではなく、開発者コミュニティの機能という位置づけです。リポジトリにも "This is not an officially supported Google product." とあり、利用は自己責任でお願いします。

カステラ・GWSCLI スキルプロジェクト（ダウンロード＆使い方）

当記事で紹介している「カステラ」は、Antigravity 用の GWSCLI 活用スキルをまとめたプロジェクトです。ZIP を解凍したフォルダをプロジェクトルートとして Antigravity で開き、SKILLS を適用すると、いろいろ調べた内容がすでにスキル内に含まれているため、会話の流れのなかでGWSCLI の設定から LOGIN までスムーズに網羅されます。
スキルや文字化け回避の詳細はAntigravity でスキルから gws を実際に使うまで・文字化け回避を参照してください。会話で「カステラ」と送るとスキルが発動します。Antigravity のクオータ・制限についてはAntigravity × Google ONE AI プラン｜Compute Quota の要点を参照してください。

配布した ZIP をプロジェクトルートにして Antigravity を起動し、会話で魔法の言葉「カステラ」と唱えると、カステラ・マスターが出現し（笑）、環境チェックやスキル同期の案内が始まります。

【重要】OAuth 用の JSON（client_secret_xxx.json）は ZIP に含まれません。利用するには、各自が Google Cloud コンソール（API とサービス → 認証情報）から OAuth 2.0 クライアント ID の JSON をダウンロードし、gws auth setup "path/to/client_secret.json" および gws auth login で認証してください。

中身の流れ（コードに基づく説明）：

1. 環境チェック — .agent/skills/kasutera_master/scripts/check_env.ps1 が、gws の有無・OS・ユーザー名・プロファイルパスを表示。ユーザー名に日本語（マルチバイト）が含まれると警告し、インストール失敗の可能性を案内する。
2. 公式スキルの一括取得 — gws-skills-sync.ps1 が GitHub API（api.github.com/repos/googleworkspace/cli/contents/skills）で公式リポジトリの skills 一覧を取得し、各ディレクトリの SKILL.md を .agent/skills/<名前> にダウンロード。開発元（Google Workspace CLI）のスキルをすべて取り込む。
3. カステラ・スイート（自作スキル） — 同じスクリプトが、ワークスペース内の「カステラ」系カスタムスキル（kasutera_master を総帥とする kasutera_gmail・kasutera_drive・kasutera_sheets・kasutera_calendar など）を .agent/skills に配置。ZIP にはこれらがすでに同梱されているため、解凍するだけで「カステラの魔法」が使える状態になる。
4. CLI の導入・修復 — gws が未インストールなら npm install -g @googleworkspace/cli を案内。Windows でマルチバイトパスにより gws.exe が展開されない（ENOENT）場合は、GitHub Releases から ZIP を取得して .bin_real に展開する自動修復をスクリプト内で実行する。
5. 認証確認 — ~/.config/gws/client_secret.json の有無と gws の認証状態をチェック。未設定なら gws auth setup / gws auth login を促す。

まとめると、プロジェクトルートで開く → 会話で「カステラ」と送る → カステラ・マスター（kasutera_master）が環境チェックとスキル同期を案内 → ユーザーが JSON を用意して gws auth setup / gws auth login を済ませれば、公式スキル＋カステラ・スキル一式で gws を自然言語から利用できます。

会社で役立つ4つの使い方

gws とスキルやワークフローを組み合わせると、次のような「朝やったらいいこと」「会議前にやったらいいこと」がまとめてチェックできたり、メールの仕分けやデータの自動記録がしやすくなります。

1. モーニング・ブリーフ（朝の状況報告） — gws workflow +standup-report で、今日のカレンダー予定と Google Tasks の未完了タスクを一画面で確認。「今日、何せなあかんねん？」が一瞬でわかる。
2. ミーティングの下調べ — gws workflow +meeting-prep で、次の会議の場所・時間・参加メンバー・資料リンクを抽出。会議直前に「資料どこやっけ？」と慌てない。
3. インボックス・トリアージ（メール仕分け） — gws gmail +triage --max 10 で受信トレイ最新10件の送信者と件名だけをリスト。返信が必要なメールをすぐ見つける。
4. 経費・データの自動記録 — Gmail で届いた領収書やデータから金額・日付を抜き取り、gws sheets values append でスプレッドシートに追記。手入力から解放。

試してみた①：今週のメールを分析してスライド作成

「今週届いたメールを分析して、SLIDEを作成。グラフィカルな」と自然言語で指示すると（スキルで gws を動かす手順は前回記事参照）、gws が Gmail のメッセージ一覧を取得し、内容を要約した Google スライドが自動作成されます。

試してみた②：過去1ヶ月の受信時間・件数をグラフで

「メールで、過去1ヶ月間の受信した時間と件数をグラフで確認したい」と依頼すると、Gmail から過去1ヶ月分（約500件）をスキャンし、時間帯別の件数やピークをアスキーアートのグラフ付きでスライドにまとめてくれました。

試してみた③：定期的な「プロジェクト進捗まとめ」配信（Drive → Sheets → Gmail）

共有フォルダにある最新の成果物（ドキュメントやファイル）をリストアップして、進捗状況と一緒に上司やチームに報連相する——という高度な連携も gws で組み立てられます。

流れ：

• gws drive で特定のプロジェクトフォルダ内の「更新日」が新しいファイルを抽出。
• gws sheets にある TODO リストの消化状況を読み取る（または Drive 上の TODO ファイルを読み取る）。
• それらを AI が要約して、gws gmail で週次レポートとして送信。

Drive の認証が必要な場合は、事前に gws auth login でログインしておきます。

毎週金曜の夕方に自動実行したり、特定フォルダに新規ファイルが追加されたらトリガーにするなど、カスタマイズの幅も広がります。
会社で使える「秘書モード」として、ドキュメント PDF 化やカレンダー連携の強化など、次の自動化にもつなげやすいパターンです。

豆知識：躓きポイントと回避

• 認証スコープ — 基本は gws auth login だけでよい。@gmail.com などで「テストモード制限（約25個）」に引っかかってエラーになる場合は、gws auth login --scopes drive,gmail,sheets,calendar のように使うサービスだけに絞る。閲覧だけなら --scopes readonly。Windows で --scopes recommended がエラーになる場合もあるので、そのときは上記のようにサービス名で指定。詳細は同フォルダの GWS_AUTH_SCOPES_GUIDE.md 参照。
• Google Chat — Chat などは組織の GWS 契約がないと使えない場合がある。個人の @gmail.com だけでは API が使えないことがあるので注意。
• Windows でインストール後に gws が動かない（ENOENT） — ユーザー名に日本語（多バイト文字）が含まれるパスだと、postinstall で gws.exe の展開に失敗し、.bin_real が空のままになることがある。対処：GitHub の Releases から Windows 用 ZIP（例: gws-x86_64-pc-windows-msvc.zip）をダウンロードし、%APPDATA%\npm\node_modules\@googleworkspace\cli\node_modules\.bin_real に展開して gws.exe を置く。可能ならユーザー名を全角避けると予防になる。詳細は同フォルダの GWS_CLI_INSTALL_ERROR_GUIDE.md 参照。

朝のスタンドアップや会議準備、メール仕分け、経費記録に加え、自然言語で「メールを分析してスライドにまとめて」と頼むだけでレポートができるので、会議の共有や振り返りがラクになります。
第1回・第2回の入門・Antigravity 連携とあわせて、gws でできることを少しずつ広げていくとよいと思います。