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-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.

Contents

Discovered from source

Skills 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"
オプション必須説明
--nameYesスクリプト名
--parent-idNo親ドキュメントID(スプレッドシート等に紐付ける場合)

コード更新

python ${CLAUDE_PLUGIN_ROOT}/scripts/google_apps_script.py update \
  --script-id "スクリプトID" \
  --filename "Code.gs" \
  --code "function myFunction() { ... }"
オプション必須説明
--script-idYesスクリプトID
--filenameYesファイル名(.gs, .html, .json)
--codeYesコード内容

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 にアクセス

  1. Google Cloud Console にアクセス
  2. 上部の「プロジェクトを選択」→「新しいプロジェクト」
  3. プロジェクト名を入力(例: 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 が設定されていません」と表示されたら「開始」をクリック)

  1. アプリ情報

    • アプリ名: 任意(例: Claude Code Plugins)
    • ユーザーサポートメール: 自分のメールアドレス
    • 「次へ」
  2. 対象

    • 「外部」を選択
    • 「次へ」
  3. 連絡先情報

    • メールアドレス: 自分のメールアドレス
    • 「次へ」
  4. 終了

    • 「Google API サービス: ユーザーデータに関するポリシー」に同意
    • 「続行」
  5. テストユーザーを追加(重要)

    • 左メニューの「対象」をクリック
    • 「+ Add users」をクリック
    • 使いたい Google アカウントのメールアドレスを追加(複数可)

4. OAuth クライアント ID を作成

左メニュー → クライアント

  1. 「+ クライアントを作成」をクリック
  2. アプリケーションの種類: デスクトップアプリ
  3. 名前: 任意(例: Claude Code)
  4. 「作成」
  5. 作成直後に 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 "初期テキスト"
オプション必須説明
--nameYesドキュメント名
--folder-idNo保存先フォルダID
--contentNo初期テキスト

テキスト追加

python ${CLAUDE_PLUGIN_ROOT}/scripts/google_docs.py update \
  --doc-id "ドキュメントID" \
  --content "追加テキスト" \
  --append
オプション必須説明
--doc-idYesドキュメントID
--contentYes追加テキスト
--appendNo末尾に追加(省略時は先頭に挿入)

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 "フォームの説明"
オプション必須説明
--nameYesフォーム名
--descriptionNoフォームの説明

質問追加

python ${CLAUDE_PLUGIN_ROOT}/scripts/google_forms.py add-question \
  --form-id "フォームID" \
  --question "質問文" \
  --type RADIO \
  --options "選択肢1,選択肢2,選択肢3" \
  --required
オプション必須説明
--form-idYesフォームID
--questionYes質問文
--typeYes質問タイプ(TEXT, PARAGRAPH, RADIO, CHECKBOX, DROP_DOWN, SCALE, DATE, TIME)
--optionsNo選択肢(カンマ区切り、RADIO/CHECKBOX/DROP_DOWN 時)
--requiredNo必須フラグ

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_create
  • mcp__notebooklm-mcp__research_start
  • mcp__notebooklm-mcp__research_poll
  • mcp__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. ポーリング(完了待ち)

以下の手順でステータスをポーリングする:

  1. mcp__notebooklm-mcp__research_poll(notebook_id="{notebook_id}") を呼び出す
  2. status を確認:
    • 完了 → ステップ 8 へ
    • 処理中 → Bash sleep 60 で 1 分待機してから再度 1 へ
    • エラー → ユーザーにエラー内容を報告して終了
  3. 最大 15 分(初回 3 分 + ポーリング 12 回 × 1 分)まで繰り返す
  4. タイムアウトした場合はユーザーに「ディープリサーチがまだ完了していません。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_create
  • mcp__notebooklm-mcp__notebook_list
  • mcp__notebooklm-mcp__note_create
  • mcp__notebooklm-mcp__source_list
  • mcp__notebooklm-mcp__studio_create
  • mcp__notebooklm-mcp__studio_status
  • mcp__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. 新規ノートブックの場合
  1. AskUserQuestion でノートブック名を質問する
  2. AskUserQuestion でソースとなるテキスト内容を質問する(インフォグラフィック化したい情報を入力してもらう)
  3. ノートブックを作成する:
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
  1. 入力されたテキストをノートとして追加する:
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要約・概要ソース全体の要点を図解にまとめるlandscapestandard
comparison比較・対比複数の対象を並べて特徴・メリデメを比較landscapedetailed
timelineタイムライン・プロセス時系列の流れやステップを順序立てて図解landscapestandard

テンプレート一覧(グループ 2):

ID名前説明推奨 orientation推奨 detail_level
statistics統計・データ数値データやトレンドをビジュアル化portraitdetailed
listリスト・ランキング項目を順位や重要度順に整理して一覧化portraitstandard
flowchartフローチャート意思決定やプロセスの分岐を視覚化landscapedetailed

テンプレート一覧(グループ 3):

ID名前説明推奨 orientation推奨 detail_level
hierarchy階層・構造組織図・分類・ピラミッド等の階層を図解portraitstandard
geographic地理・マップ地域ごとのデータや位置関係を地図で表現landscapedetailed

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. ポーリング(完了待ち)

以下の手順でステータスをポーリングする:

  1. mcp__notebooklm-mcp__studio_status(notebook_id="{notebook_id}") を呼び出す
  2. status を確認:
    • 完了 → artifact_id を取得してステップ 9 へ
    • 処理中 → Bash sleep 30 で 30 秒待機してから再度 1 へ
    • エラー → ユーザーにエラー内容を報告して終了
  3. 最大 10 分(初回 1 分 + ポーリング 18 回 × 30 秒)まで繰り返す
  4. タイムアウトした場合はユーザーに「インフォグラフィック作成がまだ完了していません。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_create
  • mcp__notebooklm-mcp__notebook_list
  • mcp__notebooklm-mcp__note_create
  • mcp__notebooklm-mcp__source_list
  • mcp__notebooklm-mcp__studio_create
  • mcp__notebooklm-mcp__studio_status
  • mcp__notebooklm-mcp__artifact_download
  • mcp__notebooklm-mcp__artifact_export
  • mcp__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. 新規ノートブックの場合
  1. AskUserQuestion でノートブック名を質問する
  2. AskUserQuestion でソースとなるテキスト内容を質問する(レポート化したい情報を入力してもらう)
  3. ノートブックを作成する:
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
  1. 入力されたテキストをノートとして追加する:
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
faqFAQソースの内容をよくある質問と回答の形式で整理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. ポーリング(完了待ち)

以下の手順でステータスをポーリングする:

  1. mcp__notebooklm-mcp__studio_status(notebook_id="{notebook_id}") を呼び出す
  2. status を確認:
    • 完了 → artifact_id を取得してステップ 7 へ
    • 処理中 → Bash sleep 15 で 15 秒待機してから再度 1 へ
    • エラー → ユーザーにエラー内容を報告して終了
  3. 最大 6 分(ポーリング 24 回 × 15 秒)まで繰り返す
  4. タイムアウトした場合はユーザーに「レポート作成がまだ完了していません。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_create
  • mcp__notebooklm-mcp__notebook_list
  • mcp__notebooklm-mcp__note_create
  • mcp__notebooklm-mcp__source_list
  • mcp__notebooklm-mcp__studio_create
  • mcp__notebooklm-mcp__studio_status
  • mcp__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. 新規ノートブックの場合
  1. AskUserQuestion でノートブック名を質問する
  2. AskUserQuestion でソースとなるテキスト内容を質問する(スライド化したい情報を入力してもらう)
  3. ノートブックを作成する:
mcp__notebooklm-mcp__notebook_create(title="{ノートブック名}")
  1. 入力されたテキストをノートとして追加する:
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_slidesdefault
comparison比較・対比複数の対象を並べて特徴・メリデメを比較detailed_deckdefault
timelineタイムライン・ロードマップ時系列の流れやマイルストーンをスライドで表現presenter_slidesdefault
report報告・レポート調査結果やステータスを報告するスライドdetailed_deckdefault

テンプレート一覧(グループ 2):

ID名前説明推奨 deck_format推奨 deck_length
pitchピッチ・提案企画提案やビジネスプレゼン向けスライドpresenter_slidesshort
training研修・教育トレーニングや学習用のスライドdetailed_deckdefault
analysis分析・考察データ分析や深堀り考察をまとめるスライドdetailed_deckdefault
guideガイド・手順書ステップバイステップの手順を説明するスライドpresenter_slidesdefault

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. ポーリング(完了待ち)

以下の手順でステータスをポーリングする:

  1. mcp__notebooklm-mcp__studio_status(notebook_id="{notebook_id}") を呼び出す
  2. status を確認:
    • 完了 → artifact_id を取得してステップ 8 へ
    • 処理中 → Bash sleep 60 で 1 分待機してから再度 1 へ
    • エラー → ユーザーにエラー内容を報告して終了
  3. 最大 20 分(初回 5 分 + ポーリング 15 回 × 1 分)まで繰り返す
  4. タイムアウトした場合はユーザーに「スライドデッキ作成がまだ完了していません。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"
オプション必須説明
--nameYesスプレッドシート名
--folder-idNo保存先フォルダID

セル更新

python ${CLAUDE_PLUGIN_ROOT}/scripts/google_sheets.py update \
  --sheet-id "シートID" \
  --range "A1:B2" \
  --values '[["値1","値2"],["値3","値4"]]'
オプション必須説明
--sheet-idYesスプレッドシートID
--rangeYesセル範囲(例: A1, A1:B2)
--valuesYes値(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"
オプション必須説明
--nameYesプレゼンテーション名
--folder-idNo保存先フォルダID

スライド追加

python ${CLAUDE_PLUGIN_ROOT}/scripts/google_slides.py add-slide \
  --presentation-id "プレゼンテーションID" \
  --title "スライドタイトル" \
  --body "スライド本文" \
  --layout TITLE_AND_BODY
オプション必須説明
--presentation-idYesプレゼンテーションID
--titleNoスライドタイトル
--bodyNoスライド本文
--layoutNoレイアウト(BLANK, TITLE, TITLE_AND_BODY, TITLE_AND_TWO_COLUMNS)

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-google
Category
Productivity

More from shiiman/claude-code-plugins

All 9