| name | auth-setup |
| description | Google OAuth クライアント設定の手順を案内する。「OAuth 設定」「Google 認証の準備」「クライアント ID 作成」「認証手順を教えて」「Google ログイン準備」「OAuth セットアップ」「認証設定したい」などで起動。 |
| allowed-tools | ["Read"] |
Auth Setup
Google OAuth クライアント（デスクトップアプリ）の作成手順を案内します。
前提条件
pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib
手順
1. Google Cloud Console にアクセス
- Google Cloud Console にアクセス
- 上部の「プロジェクトを選択」→「新しいプロジェクト」
- プロジェクト名を入力（例:
claude-code-plugins）して「作成」
2. API を有効化
メニュー → API とサービス → ライブラリ で以下を検索して有効化:
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
- Google Forms API
- Apps Script API
- Google Calendar API
- Gmail API
3. OAuth 同意画面を設定
メニュー → Google Auth Platform → ブランディング
（「Google Auth Platform が設定されていません」と表示されたら「開始」をクリック）
-
アプリ情報
- アプリ名: 任意（例:
Claude Code Plugins）
- ユーザーサポートメール: 自分のメールアドレス
- 「次へ」
-
対象
-
連絡先情報
-
終了
- 「Google API サービス: ユーザーデータに関するポリシー」に同意
- 「続行」
-
テストユーザーを追加（重要）
- 左メニューの「対象」をクリック
- 「+ Add users」をクリック
- 使いたい Google アカウントのメールアドレスを追加（複数可）
4. OAuth クライアント ID を作成
左メニュー → クライアント
- 「+ クライアントを作成」をクリック
- アプリケーションの種類: デスクトップアプリ
- 名前: 任意（例:
Claude Code）
- 「作成」
- 作成直後に JSON をダウンロード（後からダウンロードできない場合あり）
5. クライアント設定を配置
mkdir -p ~/.config/shiiman-google/clients
mv ~/Downloads/client_secret_*.json ~/.config/shiiman-google/clients/default.json
6. 認証を実行
「Google ログインして」または「認証して」と言って認証を実行してください。
よくある質問
Q: OAuth クライアントは自動作成できる？
いいえ。セキュリティ上の理由で Google Cloud Console での手動作成が必須です。
Q: OAuth 以外の認証方法は？
個人の Google アカウントデータ（Gmail, Calendar 等）にアクセスするには OAuth が唯一の方法です。API キーやサービスアカウントでは個人データにアクセスできません。
Q: ドメインごとに OAuth クライアントが必要？
いいえ。1 つの OAuth クライアントで複数の Google アカウント（異なるドメイン含む）に対応できます。--profile オプションでアカウントを切り替えられます。
注意事項
- クライアント設定ファイル（
default.json）には秘密情報が含まれています
- Git にコミットしないでください
- 複数アカウントを使う場合は、プロファイル名を指定して認証できます
