
shiiman-google
Google Workspace 操作 - 認証、Drive 検索、Docs/Sheets/Slides/Forms/Apps Script 編集、Calendar、Gmail 未読管理、NotebookLM リサーチ・アーティファクト作成を提供
- version
- 3.4.3
- GitHub stars
- 7
Install
/plugin install shiiman-google@shiiman-claude-code-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.
Contents
Discovered from sourceSkills 16
Apps Script Editor
Google Apps Script プロジェクトの新規作成・コード更新を行います。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:apps-script - Apps Script Editor
概要:
Google Apps Script プロジェクトの新規作成・コード更新を行います。
使用方法:
/shiiman-google:apps-script [オプション]
オプション:
--help このヘルプを表示
ワークフロー
新規作成
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_apps_script.py create \
--name "スクリプト名" \
--parent-id "親ドキュメントID"
| オプション | 必須 | 説明 |
|---|---|---|
--name | Yes | スクリプト名 |
--parent-id | No | 親ドキュメントID(スプレッドシート等に紐付ける場合) |
コード更新
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_apps_script.py update \
--script-id "スクリプトID" \
--filename "Code.gs" \
--code "function myFunction() { ... }"
| オプション | 必須 | 説明 |
|---|---|---|
--script-id | Yes | スクリプトID |
--filename | Yes | ファイル名(.gs, .html, .json) |
--code | Yes | コード内容 |
Auth Login
Google OAuth 認証を実行してトークンを取得・保存します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:auth-login - Auth Login
概要:
Google OAuth 認証を実行してトークンを取得・保存します。
使用方法:
/shiiman-google:auth-login [オプション]
オプション:
--help このヘルプを表示
実行方法
基本的な認証(デフォルトプロファイル)
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py login
プロファイルを指定して認証
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py login --profile work
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py login --profile personal
前提条件
- クライアント設定ファイルが
~/.config/shiiman-google/clients/default.jsonに配置されていること - 未配置の場合は「OAuth 設定」と言って手順を確認してください
トークン保存先
~/.config/shiiman-google/tokens/{profile}.json
注意事項
- ブラウザが自動で開き、Google 認証画面が表示されます
- 認証完了後、ブラウザを閉じてください
- トークンは自動的に保存され、次回から再認証不要です
Auth Setup
Google OAuth クライアント(デスクトップアプリ)の作成手順を案内します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:auth-setup - Auth Setup
概要:
Google OAuth クライアント(デスクトップアプリ)の作成手順を案内します。
使用方法:
/shiiman-google:auth-setup [オプション]
オプション:
--help このヘルプを表示
前提条件
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 にコミットしないでください
- 複数アカウントを使う場合は、プロファイル名を指定して認証できます
Calendar Events
Google Calendar の予定を今日/週/月で取得します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:calendar - Calendar Events
概要:
Google Calendar の予定を今日/週/月で取得します。
使用方法:
/shiiman-google:calendar [オプション]
オプション:
--help このヘルプを表示
実行方法
今日の予定
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_calendar.py --range today
今週の予定
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_calendar.py --range week
今月の予定
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_calendar.py --range month
JSON 形式で出力
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_calendar.py --format json --range today
カレンダー一覧を取得
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_calendar.py calendars
色一覧を表示
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_calendar.py colors
期間の解釈
ユーザーの発言から期間を解釈:
- 「今日の予定」→
--range today - 「今週の予定」「週の予定」→
--range week - 「今月の予定」「月の予定」→
--range month - 指定なしの場合 →
--range today
出力項目
- start: 開始日時
- end: 終了日時
- summary: 予定名
- location: 場所
Docs Editor
Google Docs ドキュメントの新規作成・テキスト追加を行います。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:docs - Docs Editor
概要:
Google Docs ドキュメントの新規作成・テキスト追加を行います。
使用方法:
/shiiman-google:docs [オプション]
オプション:
--help このヘルプを表示
ワークフロー
新規作成
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_docs.py create \
--name "ドキュメント名" \
--folder-id "フォルダID" \
--content "初期テキスト"
| オプション | 必須 | 説明 |
|---|---|---|
--name | Yes | ドキュメント名 |
--folder-id | No | 保存先フォルダID |
--content | No | 初期テキスト |
テキスト追加
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_docs.py update \
--doc-id "ドキュメントID" \
--content "追加テキスト" \
--append
| オプション | 必須 | 説明 |
|---|---|---|
--doc-id | Yes | ドキュメントID |
--content | Yes | 追加テキスト |
--append | No | 末尾に追加(省略時は先頭に挿入) |
Drive Search
Google Drive を検索します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:drive-search - Drive Search
概要:
Google Drive を検索します。
使用方法:
/shiiman-google:drive-search [オプション]
オプション:
--help このヘルプを表示
引数
- 検索クエリ (必須): 名前の部分一致など(例:
spec)
実行方法
アクティブプロファイルで検索
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_drive.py search --query "name contains '<検索キーワード>'"
プロファイル指定で検索
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_drive.py --profile <profile-name> search --query "name contains '<検索キーワード>'"
検索クエリ例
# 名前に "spec" を含む
--query "name contains 'spec'"
# 名前に "レポート" を含む
--query "name contains 'レポート'"
# 特定の種類のファイル
--query "mimeType='application/pdf' and name contains 'spec'"
# 最近更新された
--query "modifiedTime > '2024-01-01'"
# フォルダ内を検索
--query "'<folder-id>' in parents and name contains 'spec'"
注意事項
- トークン未作成の場合は「Google ログイン」と言って認証を行ってください
Forms Editor
Google Forms フォームの新規作成・質問追加を行います。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:forms - Forms Editor
概要:
Google Forms フォームの新規作成・質問追加を行います。
使用方法:
/shiiman-google:forms [オプション]
オプション:
--help このヘルプを表示
ワークフロー
新規作成
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_forms.py create \
--name "フォーム名" \
--description "フォームの説明"
| オプション | 必須 | 説明 |
|---|---|---|
--name | Yes | フォーム名 |
--description | No | フォームの説明 |
質問追加
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_forms.py add-question \
--form-id "フォームID" \
--question "質問文" \
--type RADIO \
--options "選択肢1,選択肢2,選択肢3" \
--required
| オプション | 必須 | 説明 |
|---|---|---|
--form-id | Yes | フォームID |
--question | Yes | 質問文 |
--type | Yes | 質問タイプ(TEXT, PARAGRAPH, RADIO, CHECKBOX, DROP_DOWN, SCALE, DATE, TIME) |
--options | No | 選択肢(カンマ区切り、RADIO/CHECKBOX/DROP_DOWN 時) |
--required | No | 必須フラグ |
Gmail Unread
Gmail の未読メッセージ一覧を取得します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:gmail-unread-check - Gmail Unread
概要:
Gmail の未読メッセージ一覧を取得します。
使用方法:
/shiiman-google:gmail-unread-check [オプション]
オプション:
--help このヘルプを表示
実行方法
アクティブプロファイルの未読一覧
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py unread
最大件数を指定
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py unread --max 50
全プロファイルの未読一覧
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py unread-all
未読が100件を超えるか確認
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py unread-all --show-has-more
JSON 形式で出力
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py --format json unread
出力項目
- id: メッセージID
- subject: 件名
- from: 送信者
- date: 受信日時
追加取得について
デフォルトでは最大100件を取得します。
追加取得の確認方法
--show-has-more オプションを使用すると、指定した件数(デフォルト100件)を超える未読があるかどうかが表示されます。
出力に「※ まだ未読があります」と表示された場合は、ユーザーに追加取得するか確認してください。
追加取得の実行方法
続きを取得する場合は --max 200 のように件数を増やして再実行します。
既読化の提案
未読メッセージ表示後、既読にするか確認する:
確認した未読を既読にしますか?(shiiman-google:gmail-unread-mark で既読化できます)
Gmail Mark Read
Gmail の未読メッセージを既読化します(単体/一括)。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:gmail-unread-mark - Gmail Mark Read
概要:
Gmail の未読メッセージを既読化します(単体/一括)。
使用方法:
/shiiman-google:gmail-unread-mark [オプション]
オプション:
--help このヘルプを表示
実行方法
特定メッセージを既読化
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py mark-read --ids <message-id>
複数メッセージを一括で既読化
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py mark-read --ids <id1> <id2> <id3>
未読メッセージを一括で既読化
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py mark-read --all
プロファイル指定
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_gmail.py --profile <profile-name> mark-read --all
オプション
--ids <id1> <id2> ...: 既読化するメッセージIDのリスト(スペース区切り)--all: 全ての未読メッセージを既読化
関連操作
- 未読一覧を確認:
shiiman-google:gmail-unread-checkを実行
注意事項
- トークン未作成の場合は「Google ログイン」と言って認証を行ってください
--allオプションは全ての未読を既読化するため、慎重に使用してください
NotebookLM Deep Research
NotebookLM でノートブックを新規作成し、ディープリサーチを実行してソースをインポートする。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:notebooklm-deepresearch - NotebookLM Deep Research
概要:
ノートブックを新規作成し、ディープリサーチを実行してソースをインポートします。
使用方法:
/shiiman-google:notebooklm-deepresearch [オプション]
オプション:
--help このヘルプを表示
使用する MCP ツール
mcp__notebooklm-mcp__notebook_createmcp__notebooklm-mcp__research_startmcp__notebooklm-mcp__research_pollmcp__notebooklm-mcp__research_import
ワークフロー
1. MCP ツールのロード
ToolSearch で +notebooklm を検索し、notebooklm-mcp の MCP ツールをロードする。
ツールが見つからない場合は「notebooklm-mcp MCP サーバーが設定されていません。MCP サーバーの設定を確認してください。」と案内して終了する。
2. ノートブック名の入力
$ARGUMENTS にノートブック名が含まれていればそれを使用する。なければ AskUserQuestion でノートブック名を質問する。
3. ノートブック作成
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
作成されたノートブックの notebook_id を保持する。
4. リサーチクエリの入力
AskUserQuestion でリサーチクエリを質問する。
5. ディープリサーチ開始
mcp__notebooklm-mcp__research_start(
notebook_id="{notebook_id}",
query="{リサーチクエリ}",
source_type="web",
mode="deep"
)
戻り値から task_id を保持する。
6. 初回待機
ディープリサーチは時間がかかるため、まず 3 分待機する。
sleep 180
7. ポーリング(完了待ち)
以下の手順でステータスをポーリングする:
mcp__notebooklm-mcp__research_poll(notebook_id="{notebook_id}")を呼び出す- status を確認:
- 完了 → ステップ 8 へ
- 処理中 → Bash
sleep 60で 1 分待機してから再度 1 へ - エラー → ユーザーにエラー内容を報告して終了
- 最大 15 分(初回 3 分 + ポーリング 12 回 × 1 分)まで繰り返す
- タイムアウトした場合はユーザーに「ディープリサーチがまだ完了していません。NotebookLM の Web UI で直接確認してください。」と報告する
8. リサーチ結果のインポート
mcp__notebooklm-mcp__research_import(
notebook_id="{notebook_id}",
task_id="{task_id}"
)
sources パラメータは省略し、全件自動インポートする。
9. 完了報告
インポート結果をユーザーに表示する。ノートブック名、インポートされたソース数を含める。
注意事項
- notebooklm-mcp MCP サーバーが起動していない場合、ToolSearch でツールが見つからない。その場合は MCP サーバーの設定確認を案内する
- 認証エラーの場合は
mcp__notebooklm-mcp__refresh_authでの再認証を案内する - ディープリサーチは完了まで数分〜十数分かかる場合がある
NotebookLM Infographic
NotebookLM のノートブックからインフォグラフィックを作成する。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:notebooklm-infographic - NotebookLM Infographic
概要:
ノートブックのソースからインフォグラフィックを作成します。
使用方法:
/shiiman-google:notebooklm-infographic [オプション]
オプション:
--help このヘルプを表示
使用する MCP ツール
mcp__notebooklm-mcp__notebook_createmcp__notebooklm-mcp__notebook_listmcp__notebooklm-mcp__note_createmcp__notebooklm-mcp__source_listmcp__notebooklm-mcp__studio_createmcp__notebooklm-mcp__studio_statusmcp__notebooklm-mcp__artifact_download
ワークフロー
1. MCP ツールのロード
ToolSearch で +notebooklm を検索し、notebooklm-mcp の MCP ツールをロードする。
ツールが見つからない場合は「notebooklm-mcp MCP サーバーが設定されていません。MCP サーバーの設定を確認してください。」と案内して終了する。
2. ノートブックの準備
AskUserQuestion でノートブックの準備方法を選択してもらう:
- 既存のノートブックを使う — 作成済みのノートブックから選択
- 新規ノートブックを作成 — タイトルと内容を指定して新規作成
2a. 既存ノートブックの場合
mcp__notebooklm-mcp__notebook_list()
ノートブック一覧を取得し、AskUserQuestion で対象ノートブックの選択を求める。選択されたノートブックの notebook_id を保持する。
2b. 新規ノートブックの場合
- AskUserQuestion でノートブック名を質問する
- AskUserQuestion でソースとなるテキスト内容を質問する(インフォグラフィック化したい情報を入力してもらう)
- ノートブックを作成する:
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
- 入力されたテキストをノートとして追加する:
mcp__notebooklm-mcp__note_create(
notebook_id="{notebook_id}",
content="{テキスト内容}",
title="{ノートブック名}"
)
作成されたノートブックの notebook_id を保持する。
3. ビジュアルスタイルの選択
AskUserQuestion でビジュアルスタイルを選択してもらう:
- おまかせ(auto_select) — NotebookLM が最適なスタイルを自動選択(推奨)
- スタイルを指定する — 10 種のビジュアルスタイルから手動で選択
「おまかせ」の場合は infographic_style = "auto_select" を設定してステップ 4 へ進む。
「スタイルを指定する」の場合、AskUserQuestion で 3 つずつ選択肢を提示する(テンプレート 3 つ +「他のスタイルを見る」で 4 枠を使い、3 回に分けて表示)。
スタイル一覧(グループ 1):
| ID | 名前 | 説明 |
|---|---|---|
sketch_note | スケッチノート | 手書き風のカジュアルなノートスタイル |
professional | プロフェッショナル | ビジネス向けの洗練されたスタイル |
bento_grid | ベントグリッド | 格子状に情報を整理するモダンなレイアウト |
スタイル一覧(グループ 2):
| ID | 名前 | 説明 |
|---|---|---|
editorial | エディトリアル | 雑誌・出版物風のデザインスタイル |
instructional | インストラクショナル | 教材・マニュアル向けの説明的スタイル |
bricks | ブリック | ブロック状の構造的なレイアウト |
スタイル一覧(グループ 3):
| ID | 名前 | 説明 |
|---|---|---|
clay | クレイ | 粘土・3D 風のやわらかいビジュアル |
anime | アニメ | アニメ・イラスト風のカラフルなスタイル |
kawaii | カワイイ | かわいい・ポップなデザインスタイル |
scientific | サイエンティフィック | 学術・科学向けの正確で整然としたスタイル |
1 回目: sketch_note, professional, bento_grid, 他のスタイルを見る 2 回目(1 回目で「他のスタイルを見る」を選んだ場合): editorial, instructional, bricks, 他のスタイルを見る 3 回目(2 回目で「他のスタイルを見る」を選んだ場合): clay, anime, kawaii, scientific
選択されたスタイルの ID を infographic_style として保持する。
4. プロンプト方式の選択
AskUserQuestion でプロンプトの入力方式を選択してもらう:
- テンプレートから選ぶ — プリセットテンプレートを使用(推奨)
- カスタムプロンプトを入力 — 自由にプロンプトを入力
4a. テンプレート選択の場合
assets/prompts/ 配下のテンプレートファイルを Read で読み込み、一覧を提示する。
テンプレート一覧(グループ 1):
| ID | 名前 | 説明 | 推奨 orientation | 推奨 detail_level |
|---|---|---|---|---|
summary | 要約・概要 | ソース全体の要点を図解にまとめる | landscape | standard |
comparison | 比較・対比 | 複数の対象を並べて特徴・メリデメを比較 | landscape | detailed |
timeline | タイムライン・プロセス | 時系列の流れやステップを順序立てて図解 | landscape | standard |
テンプレート一覧(グループ 2):
| ID | 名前 | 説明 | 推奨 orientation | 推奨 detail_level |
|---|---|---|---|---|
statistics | 統計・データ | 数値データやトレンドをビジュアル化 | portrait | detailed |
list | リスト・ランキング | 項目を順位や重要度順に整理して一覧化 | portrait | standard |
flowchart | フローチャート | 意思決定やプロセスの分岐を視覚化 | landscape | detailed |
テンプレート一覧(グループ 3):
| ID | 名前 | 説明 | 推奨 orientation | 推奨 detail_level |
|---|---|---|---|---|
hierarchy | 階層・構造 | 組織図・分類・ピラミッド等の階層を図解 | portrait | standard |
geographic | 地理・マップ | 地域ごとのデータや位置関係を地図で表現 | landscape | detailed |
AskUserQuestion で 3 つずつ選択肢を提示する(AskUserQuestion は最大 4 選択肢のため、テンプレート 3 つ +「他のテンプレートを見る」で 4 枠を使い、3 回に分けて表示)。
1 回目: summary, comparison, timeline, 他のテンプレートを見る 2 回目(1 回目で「他のテンプレートを見る」を選んだ場合): statistics, list, flowchart, 他のテンプレートを見る 3 回目(2 回目で「他のテンプレートを見る」を選んだ場合): hierarchy, geographic
選択されたテンプレートの .md ファイルを Read で読み込み:
- frontmatter の
orientationとdetail_levelを推奨値として自動設定 - body 部分を
custom_promptとして使用
推奨値をユーザーに提示し、「このパラメータで作成しますか?」と確認する。変更したい場合は個別に上書き可能。
4b. カスタムプロンプトの場合
従来どおり AskUserQuestion で自由入力を受け付ける。
5. その他パラメータ
テンプレート選択で推奨値が設定されていない場合、または変更したい場合に AskUserQuestion で入力を受ける:
| パラメータ | 説明 | デフォルト |
|---|---|---|
orientation | 向き(landscape / portrait / square) | landscape |
detail_level | 詳細度(concise / standard / detailed) | standard |
source_ids | 対象ソース(省略で全ソース) | 全ソース |
ユーザーが「デフォルトで」「そのままで」と回答した場合はデフォルト値(またはテンプレート推奨値)を使用する。
source_ids を指定したい場合は、mcp__notebooklm-mcp__source_list(notebook_id) でソース一覧を取得して選択肢を提示する。
6. インフォグラフィック作成
mcp__notebooklm-mcp__studio_create(
notebook_id="{notebook_id}",
artifact_type="infographic",
custom_prompt="{custom_prompt}",
orientation="{orientation}",
detail_level="{detail_level}",
infographic_style="{infographic_style}",
source_ids=["{source_id1}", "{source_id2}", ...]
)
指定されなかったオプションパラメータは省略する。
7. 初回待機
インフォグラフィック生成のため、まず 1 分待機する。
sleep 60
8. ポーリング(完了待ち)
以下の手順でステータスをポーリングする:
mcp__notebooklm-mcp__studio_status(notebook_id="{notebook_id}")を呼び出す- status を確認:
- 完了 →
artifact_idを取得してステップ 9 へ - 処理中 → Bash
sleep 30で 30 秒待機してから再度 1 へ - エラー → ユーザーにエラー内容を報告して終了
- 完了 →
- 最大 10 分(初回 1 分 + ポーリング 18 回 × 30 秒)まで繰り返す
- タイムアウトした場合はユーザーに「インフォグラフィック作成がまだ完了していません。NotebookLM の Web UI で直接確認してください。」と報告する
9. ダウンロード確認
AskUserQuestion でダウンロードするか確認する。
10. ダウンロード
ユーザーが「はい」の場合:
mcp__notebooklm-mcp__artifact_download(
notebook_id="{notebook_id}",
artifact_id="{artifact_id}"
)
結果(ファイルパス)をユーザーに表示する。
注意事項
- notebooklm-mcp MCP サーバーが起動していない場合、ToolSearch でツールが見つからない。その場合は MCP サーバーの設定確認を案内する
- 認証エラーの場合は
mcp__notebooklm-mcp__refresh_authでの再認証を案内する - ノートブックにソースが存在しない場合、インフォグラフィック作成が失敗する可能性がある。事前にソースの有無を確認すること
NotebookLM Report
NotebookLM のノートブックからレポート(Briefing Doc / Study Guide / Blog Post / Create Your Own)を作成する。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:notebooklm-report - NotebookLM Report
概要:
ノートブックのソースからレポートを作成します。
使用方法:
/shiiman-google:notebooklm-report [オプション]
オプション:
--help このヘルプを表示
使用する MCP ツール
mcp__notebooklm-mcp__notebook_createmcp__notebooklm-mcp__notebook_listmcp__notebooklm-mcp__note_createmcp__notebooklm-mcp__source_listmcp__notebooklm-mcp__studio_createmcp__notebooklm-mcp__studio_statusmcp__notebooklm-mcp__artifact_downloadmcp__notebooklm-mcp__artifact_exportmcp__notebooklm-mcp__refresh_auth
ワークフロー
1. MCP ツールのロード
ToolSearch で +notebooklm を検索し、notebooklm-mcp の MCP ツールをロードする。
ツールが見つからない場合は「notebooklm-mcp MCP サーバーが設定されていません。MCP サーバーの設定を確認してください。」と案内して終了する。
2. ノートブックの準備
AskUserQuestion でノートブックの準備方法を選択してもらう:
- 既存のノートブックを使う — 作成済みのノートブックから選択
- 新規ノートブックを作成 — タイトルと内容を指定して新規作成
2a. 既存ノートブックの場合
mcp__notebooklm-mcp__notebook_list()
ノートブック一覧を取得し、AskUserQuestion で対象ノートブックの選択を求める。選択されたノートブックの notebook_id を保持する。
2b. 新規ノートブックの場合
- AskUserQuestion でノートブック名を質問する
- AskUserQuestion でソースとなるテキスト内容を質問する(レポート化したい情報を入力してもらう)
- ノートブックを作成する:
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
- 入力されたテキストをノートとして追加する:
mcp__notebooklm-mcp__note_create(
notebook_id="{notebook_id}",
content="{テキスト内容}",
title="{ノートブック名}"
)
作成されたノートブックの notebook_id を保持する。
3. プロンプト方式の選択
AskUserQuestion でプロンプトの入力方式を選択してもらう:
- テンプレートから選ぶ — プリセットテンプレートを使用(推奨)
- カスタムプロンプトを入力 — 自由にプロンプトを入力
3a. テンプレート選択の場合
assets/prompts/ 配下のテンプレートファイルを Read で読み込み、一覧を提示する。
テンプレート一覧(グループ 1):
| ID | 名前 | 説明 | 推奨 report_format |
|---|---|---|---|
briefing | ブリーフィング | ソースの要点・知見・提言をまとめた簡潔なサマリー | Briefing Doc |
study-guide | 学習ガイド | 学習者向けに重要概念・用語・復習問題を整理 | Study Guide |
faq | FAQ | ソースの内容をよくある質問と回答の形式で整理 | Create Your Own |
blog-post | ブログポスト | ソースの内容を読みやすいブログ記事に変換 | Blog Post |
テンプレート一覧(グループ 2):
| ID | 名前 | 説明 | 推奨 report_format |
|---|---|---|---|
executive | エグゼクティブサマリー | 意思決定者向けの簡潔な概要・結論・提言 | Briefing Doc |
comparison | 比較レポート | 複数の対象を比較分析してまとめるレポート | Briefing Doc |
action-plan | アクションプラン | ソースから具体的な行動計画・タスクリストを抽出 | Briefing Doc |
pros-cons | メリット・デメリット | 特定のトピックの長所・短所を整理して評価 | Briefing Doc |
AskUserQuestion で最大 4 つまで選択肢を提示できる前提で、テンプレート選択は 2 段階で行う。
1 回目: テンプレートグループの選択
- 「汎用テンプレート(briefing / study-guide / faq / blog-post)」
- 「ビジネステンプレート(executive / comparison / action-plan / pros-cons)」
2 回目: 選択したグループに含まれる 4 テンプレートから 1 つを選択する。
選択されたテンプレートの .md ファイルを Read で読み込み:
- frontmatter の
report_formatを推奨値として自動設定 - body 部分を
custom_promptとして使用
推奨値をユーザーに提示し、「このパラメータで作成しますか?」と確認する。変更したい場合は個別に上書き可能。
3b. カスタムプロンプトの場合
従来どおり AskUserQuestion で自由入力を受け付ける。
4. その他パラメータ
テンプレート選択で推奨値が設定されていない場合、または変更したい場合に AskUserQuestion で入力を受ける:
| パラメータ | 説明 | デフォルト |
|---|---|---|
report_format | フォーマット(Briefing Doc / Study Guide / Blog Post / Create Your Own) | Briefing Doc |
source_ids | 対象ソース(省略で全ソース) | 全ソース |
ユーザーが「デフォルトで」「そのままで」と回答した場合はデフォルト値(またはテンプレート推奨値)を使用する。
source_ids を指定したい場合は、mcp__notebooklm-mcp__source_list(notebook_id) でソース一覧を取得して選択肢を提示する。
5. レポート作成
mcp__notebooklm-mcp__studio_create(
notebook_id="{notebook_id}",
artifact_type="report",
custom_prompt="{custom_prompt}",
report_format="{report_format}", # デフォルト: Briefing Doc
source_ids=["{source_id1}", "{source_id2}", ...]
)
指定されなかったオプションパラメータは省略する。
6. ポーリング(完了待ち)
以下の手順でステータスをポーリングする:
mcp__notebooklm-mcp__studio_status(notebook_id="{notebook_id}")を呼び出す- status を確認:
- 完了 →
artifact_idを取得してステップ 7 へ - 処理中 → Bash
sleep 15で 15 秒待機してから再度 1 へ - エラー → ユーザーにエラー内容を報告して終了
- 完了 →
- 最大 6 分(ポーリング 24 回 × 15 秒)まで繰り返す
- タイムアウトした場合はユーザーに「レポート作成がまだ完了していません。NotebookLM の Web UI で直接確認してください。」と報告する
7. ダウンロード/エクスポートの選択
AskUserQuestion でダウンロード方法を選択してもらう:
- ローカルにダウンロード — ファイルとしてダウンロード(デフォルト)
- Google Docs にエクスポート — Google Docs にエクスポート
- 不要 — ダウンロードしない
8. ダウンロード/エクスポート
選択に応じて実行する:
ローカルダウンロードの場合:
mcp__notebooklm-mcp__artifact_download(
notebook_id="{notebook_id}",
artifact_id="{artifact_id}"
)
Google Docs エクスポートの場合:
mcp__notebooklm-mcp__artifact_export(
notebook_id="{notebook_id}",
artifact_id="{artifact_id}",
export_type="docs"
)
結果(ファイルパスまたは Google Docs URL)をユーザーに表示する。
注意事項
- notebooklm-mcp MCP サーバーが起動していない場合、ToolSearch でツールが見つからない。その場合は MCP サーバーの設定確認を案内する
- 認証エラーの場合は
mcp__notebooklm-mcp__refresh_authでの再認証を案内する - ノートブックにソースが存在しない場合、レポート作成が失敗する可能性がある。事前にソースの有無を確認すること
- レポートはテキストベースのため、スライドやインフォグラフィックと異なりダウンロード形式の選択はない(デフォルトで Markdown/テキスト形式)
- Google Docs へのエクスポートにより、後からの編集・共有が容易になる
NotebookLM Slide Deck
NotebookLM のノートブックからスライドデッキを作成する。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:notebooklm-slide - NotebookLM Slide Deck
概要:
ノートブックのソースからスライドデッキを作成します。
使用方法:
/shiiman-google:notebooklm-slide [オプション]
オプション:
--help このヘルプを表示
使用する MCP ツール
mcp__notebooklm-mcp__notebook_createmcp__notebooklm-mcp__notebook_listmcp__notebooklm-mcp__note_createmcp__notebooklm-mcp__source_listmcp__notebooklm-mcp__studio_createmcp__notebooklm-mcp__studio_statusmcp__notebooklm-mcp__artifact_download
ワークフロー
1. MCP ツールのロード
ToolSearch で +notebooklm を検索し、notebooklm-mcp の MCP ツールをロードする。
ツールが見つからない場合は「notebooklm-mcp MCP サーバーが設定されていません。MCP サーバーの設定を確認してください。」と案内して終了する。
2. ノートブックの準備
AskUserQuestion でノートブックの準備方法を選択してもらう:
- 既存のノートブックを使う — 作成済みのノートブックから選択
- 新規ノートブックを作成 — タイトルと内容を指定して新規作成
2a. 既存ノートブックの場合
mcp__notebooklm-mcp__notebook_list()
ノートブック一覧を取得し、AskUserQuestion で対象ノートブックの選択を求める。選択されたノートブックの notebook_id を保持する。
2b. 新規ノートブックの場合
- AskUserQuestion でノートブック名を質問する
- AskUserQuestion でソースとなるテキスト内容を質問する(スライド化したい情報を入力してもらう)
- ノートブックを作成する:
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
- 入力されたテキストをノートとして追加する:
mcp__notebooklm-mcp__note_create(
notebook_id="{notebook_id}",
content="{テキスト内容}",
title="{ノートブック名}"
)
作成されたノートブックの notebook_id を保持する。
3. プロンプト方式の選択
AskUserQuestion でプロンプトの入力方式を選択してもらう:
- テンプレートから選ぶ — プリセットテンプレートを使用(推奨)
- カスタムプロンプトを入力 — 自由にプロンプトを入力
3a. テンプレート選択の場合
assets/prompts/ 配下のテンプレートファイルを Read で読み込み、一覧を提示する。
テンプレート一覧(グループ 1):
| ID | 名前 | 説明 | 推奨 deck_format | 推奨 deck_length |
|---|---|---|---|---|
summary | 要約・概要 | ソース全体の要点をスライドにまとめる | presenter_slides | default |
comparison | 比較・対比 | 複数の対象を並べて特徴・メリデメを比較 | detailed_deck | default |
timeline | タイムライン・ロードマップ | 時系列の流れやマイルストーンをスライドで表現 | presenter_slides | default |
report | 報告・レポート | 調査結果やステータスを報告するスライド | detailed_deck | default |
テンプレート一覧(グループ 2):
| ID | 名前 | 説明 | 推奨 deck_format | 推奨 deck_length |
|---|---|---|---|---|
pitch | ピッチ・提案 | 企画提案やビジネスプレゼン向けスライド | presenter_slides | short |
training | 研修・教育 | トレーニングや学習用のスライド | detailed_deck | default |
analysis | 分析・考察 | データ分析や深堀り考察をまとめるスライド | detailed_deck | default |
guide | ガイド・手順書 | ステップバイステップの手順を説明するスライド | presenter_slides | default |
AskUserQuestion で 4 つずつ選択肢を提示する(AskUserQuestion は最大 4 選択肢のため、2 回に分けて表示)。
1 回目: summary, comparison, timeline, report 2 回目(1 回目で「他のテンプレートを見る」を選んだ場合): pitch, training, analysis, guide
選択されたテンプレートの .md ファイルを Read で読み込み:
- frontmatter の
deck_formatとdeck_lengthを推奨値として自動設定 - body 部分を
custom_promptとして使用
推奨値をユーザーに提示し、「このパラメータで作成しますか?」と確認する。変更したい場合は個別に上書き可能。
3b. カスタムプロンプトの場合
従来どおり AskUserQuestion で自由入力を受け付ける。
4. その他パラメータ
テンプレート選択で推奨値が設定されていない場合、または変更したい場合に AskUserQuestion で入力を受ける:
| パラメータ | 説明 | デフォルト |
|---|---|---|
deck_format | フォーマット(presenter_slides / detailed_deck) | presenter_slides |
deck_length | 長さ(short / default) | default |
source_ids | 対象ソース(省略で全ソース) | 全ソース |
ユーザーが「デフォルトで」「そのままで」と回答した場合はデフォルト値(またはテンプレート推奨値)を使用する。
source_ids を指定したい場合は、mcp__notebooklm-mcp__source_list(notebook_id) でソース一覧を取得して選択肢を提示する。
5. スライドデッキ作成
mcp__notebooklm-mcp__studio_create(
notebook_id="{notebook_id}",
artifact_type="slide_deck",
custom_prompt="{custom_prompt}",
deck_format="{deck_format}", # デフォルト: presenter_slides
deck_length="{deck_length}",
source_ids=["{source_id1}", "{source_id2}", ...]
)
指定されなかったオプションパラメータは省略する。
6. 初回待機
スライドデッキ生成のため、まず 5 分待機する。
sleep 300
7. ポーリング(完了待ち)
以下の手順でステータスをポーリングする:
mcp__notebooklm-mcp__studio_status(notebook_id="{notebook_id}")を呼び出す- status を確認:
- 完了 →
artifact_idを取得してステップ 8 へ - 処理中 → Bash
sleep 60で 1 分待機してから再度 1 へ - エラー → ユーザーにエラー内容を報告して終了
- 完了 →
- 最大 20 分(初回 5 分 + ポーリング 15 回 × 1 分)まで繰り返す
- タイムアウトした場合はユーザーに「スライドデッキ作成がまだ完了していません。NotebookLM の Web UI で直接確認してください。」と報告する
8. ダウンロード形式の選択
AskUserQuestion でダウンロード形式を選択してもらう:
- PDF でダウンロード — PDF ファイルとしてダウンロード(デフォルト)
- PPTX でダウンロード — PowerPoint ファイルとしてダウンロード
- 不要 — ダウンロードしない
9. ダウンロード
選択に応じて実行する:
PDF ダウンロードの場合:
mcp__notebooklm-mcp__artifact_download(
notebook_id="{notebook_id}",
artifact_id="{artifact_id}",
file_format="pdf"
)
PPTX ダウンロードの場合:
mcp__notebooklm-mcp__artifact_download(
notebook_id="{notebook_id}",
artifact_id="{artifact_id}",
file_format="pptx"
)
結果(ファイルパス)をユーザーに表示する。
注意事項
- notebooklm-mcp MCP サーバーが起動していない場合、ToolSearch でツールが見つからない。その場合は MCP サーバーの設定確認を案内する
- 認証エラーの場合は
mcp__notebooklm-mcp__refresh_authでの再認証を案内する - ノートブックにソースが存在しない場合、スライドデッキ作成が失敗する可能性がある。事前にソースの有無を確認すること
- 既存の
shiiman-google:slidesは Google Slides API を直接操作するスキル。本スキルは NotebookLM のソースから AI でスライドを生成する別機能
Profile Switch
保存済み認証プロファイルを切り替えます。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:profile-switch - Profile Switch
概要:
保存済み認証プロファイルを切り替えます。
使用方法:
/shiiman-google:profile-switch [オプション]
オプション:
--help このヘルプを表示
実行方法
プロファイル一覧を表示
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py profiles
プロファイルを切り替え
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py switch <profile-name>
例:
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py switch work
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_auth.py switch personal
保存場所
- 設定ディレクトリ:
~/.config/shiiman-google/ - トークンファイル:
~/.config/shiiman-google/tokens/<profile-name>.json - アクティブプロファイル:
~/.config/shiiman-google/active-profile
注意事項
- 切り替え先のプロファイルは事前に認証されている必要があります
- 新しいプロファイルを追加するには「Google ログイン」と言ってください
Sheets Editor
Google Sheets スプレッドシートの新規作成・セル更新を行います。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:sheets - Sheets Editor
概要:
Google Sheets スプレッドシートの新規作成・セル更新を行います。
使用方法:
/shiiman-google:sheets [オプション]
オプション:
--help このヘルプを表示
ワークフロー
新規作成
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_sheets.py create \
--name "スプレッドシート名" \
--folder-id "フォルダID"
| オプション | 必須 | 説明 |
|---|---|---|
--name | Yes | スプレッドシート名 |
--folder-id | No | 保存先フォルダID |
セル更新
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_sheets.py update \
--sheet-id "シートID" \
--range "A1:B2" \
--values '[["値1","値2"],["値3","値4"]]'
| オプション | 必須 | 説明 |
|---|---|---|
--sheet-id | Yes | スプレッドシートID |
--range | Yes | セル範囲(例: A1, A1:B2) |
--values | Yes | 値(JSON 配列形式) |
行追加
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_sheets.py append \
--sheet-id "シートID" \
--range "A1" \
--values '[["値1","値2"]]'
Slides Editor
Google Slides プレゼンテーションの新規作成・スライド追加を行います。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-google:slides - Slides Editor
概要:
Google Slides プレゼンテーションの新規作成・スライド追加を行います。
使用方法:
/shiiman-google:slides [オプション]
オプション:
--help このヘルプを表示
ワークフロー
新規作成
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_slides.py create \
--name "プレゼンテーション名" \
--folder-id "フォルダID"
| オプション | 必須 | 説明 |
|---|---|---|
--name | Yes | プレゼンテーション名 |
--folder-id | No | 保存先フォルダID |
スライド追加
python ${CLAUDE_PLUGIN_ROOT}/scripts/google_slides.py add-slide \
--presentation-id "プレゼンテーションID" \
--title "スライドタイトル" \
--body "スライド本文" \
--layout TITLE_AND_BODY
| オプション | 必須 | 説明 |
|---|---|---|
--presentation-id | Yes | プレゼンテーションID |
--title | No | スライドタイトル |
--body | No | スライド本文 |
--layout | No | レイアウト(BLANK, TITLE, TITLE_AND_BODY, TITLE_AND_TWO_COLUMNS) |
Sponsors
Details
- Marketplace
- shiiman/claude-code-plugins
- Source
- plugins/shiiman-google
- Category
- Productivity