gws-install

Google Workspace CLI — クイックインストール

以前のセットアップで取得した OAuth 認証情報を使って、別のマシンに gws をインストールします。認証済みの CLI が作成され、すべてのエージェントスキルをすぐに使用できます。

前提条件：以前の gws-setup（または Google Cloud Console）で取得した client_secret.json が必要です。ファイルがない場合は、代わりに gws-setup スキルを使用してください。

ワークフロー

ステップ 1：事前確認

which gws && gws --version
ls ~/.config/gws/client_secret.json
gws auth status

適切なスコープで既に認証済みの場合は、ステップ 4 に進んでください。

ステップ 2：CLI をインストールする

npm install -g @googleworkspace/cli
gws --version

ステップ 3：認証情報を設定する

client_secret.json を提供するようユーザーに依頼します。方法は 3 つあります。

オプション A — JSON の内容を貼り付ける：

JSON を貼り付けるようユーザーに依頼します。~/.config/gws/client_secret.json に書き込みます。

mkdir -p ~/.config/gws

想定される形式：

{
  "installed": {
    "client_id": "...",
    "project_id": "...",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "client_secret": "...",
    "redirect_uris": ["http://localhost"]
  }
}

オプション B — ファイルパス：

ユーザーがファイルをローカルに保存している場合（例：ダウンロードフォルダー）：

mkdir -p ~/.config/gws
cp /path/to/client_secret.json ~/.config/gws/client_secret.json

オプション C — 環境変数：

export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"

ステップ 4：認証する

重要：このステップでは、ユーザーがブラウザーで開く必要がある非常に長い OAuth URL（30 以上のスコープ）が表示されます。URL は長すぎてターミナルの出力からコピーできず、複数行に折り返されて正しくコピーできません。必ずファイルに抽出して、プログラムから開いてください。

使用する Google アカウントをユーザーに確認してから、次の手順を実行します。

1. バックグラウンドで認証を実行し、出力を取得します。

gws auth login -s gmail,drive,calendar,sheets,docs,chat,tasks 2>&1 | tee /tmp/gws-auth-output.txt

バックグラウンドタスクとして実行しても問題ありません。ユーザーがブラウザーで承認すると処理が完了します。

2. URL を抽出して開きます（出力が表示された後、別途実行します）。

grep -o 'https://accounts.google.com[^ ]*' /tmp/gws-auth-output.txt > /tmp/gws-auth-url.txt
cat /tmp/gws-auth-url.txt | xargs open

open が機能しない場合は、ユーザーに「認証 URL は /tmp/gws-auth-url.txt に保存されています。そのファイルを開き、URL をコピーしてください」と伝えてください。

3. ブラウザーでユーザーが承認するのを待ってから、確認します。

gws auth status

別の方法 — すべてのスコープに対して --full を使用する：

gws auth login --full

ユーザーは元のマシンで gws auth status を実行すると、許可されたスコープを確認できます。

ステップ 5：エージェントスキルをインストールする

npx skills add googleworkspace/cli -g --agent claude-code --all

これにより、90 以上のスキルが ~/.claude/skills/ にインストールされます。スキルが既にインストールされていても、安全に再実行できます。

ステップ 6：確認する

gws auth status
gws calendar +agenda --today
gws gmail +triage

---

トラブルシューティング

「Auth error — credentials missing or invalid」（終了コード 2）

• ~/.config/gws/client_secret.json が存在し、有効な JSON であることを確認してください
• gws auth login を再実行してください

トークンの有効期限切れ

• GCP アプリが「Testing」ステータスの場合、トークンは 7 日後に期限切れになります
• 更新するには gws auth login を再実行してください
• トークンを永続的に使用するには、GCP Console の OAuth 同意画面でアプリを本番環境に公開してください

Claude Code にスキルが表示されない

• スキルはセッション開始時に読み込まれます。インストール後に Claude Code を再起動してください
• 確認コマンド：ls ~/.claude/skills/gws-* | wc -l の結果に 30 以上のディレクトリが表示されるはずです

関連項目

• gws-setup — GCP プロジェクトの作成を含む初回セットアップ
• gws-shared — 認証パターンとグローバルフラグ