notebooklm

NotebookLM

NotebookLM は、コンテキストウィンドウでの読み込みを肩代わりする外部 RAG エンジンです。notebooklm-mcp-cli MCP サーバー（PyPI、v0.6.1+）を使用して、ノートブックの作成、ソースの管理、コンテンツの生成、ソースへのテーマ別ラベル付け、根拠に基づく AI の回答によるクエリを実行できます。ノートブックをまたぐ一括操作、パイプライン、多言語コンテンツ生成に対応しています。

免責事項：ブラウザー認証を介して、Google の非公開の内部 API を使用します。セッションの有効期間は約 20 分です。API は予告なく変更される場合があります。

新機能（2026 年 4 月 — v0.6.1）

• ソースラベル（v0.6.0 の新機能） — ソースをテーマ別のカテゴリに整理します。新しい label MCP ツールと nlm label CLI で、auto（ソースから AI が生成。5 件以上が必要）、list、create、rename、delete、assign、unassign を利用できます。NotebookLM のウェブ UI のソースフィルターに反映されます。
• ラベルの再整理（v0.6.1 の新機能） — nlm label reorganize（または action="reorganize" を指定した label MCP）を使うと、既存のラベルがある場合に AI による再分類を強制できます。2 つのモードがあります。全ソース（置き換え。--confirm が必要）または未分類のみ（既存の分類を維持）。
• 動画形式 — 3 つの形式（解説、概要、シネマティック）と 9 つのビジュアルスタイル
• 音声の長さ — audio_length パラメーター：short、default、long
• PPTX エクスポート — PDF に加えて download_artifact(slide_deck_format="pptx") に対応
• ソースの一括操作 — source_add(urls=[...])、source_delete(source_ids=[...])、source_add(wait=True)
• Studio アーティファクトの名前変更 — studio_status(action="rename", artifact_id="...", new_title="...")
• スライド／レポート／クイズのパラメーター — slide_format、report_format、difficulty と question_count
• インフォグラフィックのオプション — orientation、detail_level、11 種類の infographic_style オプション
• 音声ソース — m4a、wav、mp3、aac、ogg、opus をアップロード可能
• 大規模クエリの非同期処理 — 50 件以上のソースを含むノートブック向けの notebook_query_start／notebook_query_status
• 複数ブラウザーでの認証 — Arc、Brave、Edge、Chromium、Vivaldi、Opera と WSL2（nlm login --wsl）に対応
• エンタープライズ — Google Workspace のデプロイ向けに NOTEBOOKLM_BASE_URL 環境変数を追加
• セキュリティ — ダウンロードパスのトラバーサル対策、認証ファイルの 0o600、Chrome のオリジンを localhost に制限

前提条件

1. インストール：uv tool install notebooklm-mcp-cli（または pip install notebooklm-mcp-cli）
2. 認証：nlm login（ブラウザーが開きます。セッションの有効期間は約 20 分）
3. MCP の設定：nlm setup add claude-code（.mcp.json を自動設定）または複数のツールを設定する場合は nlm setup add all
4. 確認：nlm login --check でアクティブなセッションを確認
5. アップグレード：uv tool upgrade notebooklm-mcp-cli — アップグレード後に MCP サーバーを再起動してください

重要：タスク管理は必須です（CC 2.1.16）

ほかの作業を始める前に、進捗を追跡するタスクを作成してください：

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="NotebookLM: {operation}",
  description="Managing notebooks, sources, and content generation",
  activeForm="Managing NotebookLM resources"
)

# 2. Create subtasks for the notebook workflow
TaskCreate(subject="Notebook setup", activeForm="Creating/configuring notebook")
TaskCreate(subject="Source management", activeForm="Adding sources to notebook")
TaskCreate(subject="Content generation", activeForm="Generating studio content")

# 3. Set dependencies for sequential steps
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Before starting each task, verify it's unblocked
task = TaskGet(taskId="2")  # Verify blockedBy is empty

# 5. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

判断ツリー — 読むべきルール

What are you trying to do?
│
├── Create / manage notebooks
│   ├── List / get / rename ──────► notebook_list, notebook_get, notebook_rename
│   ├── Create new notebook ──────► notebook_create
│   └── Delete notebook ──────────► notebook_delete (irreversible!)
│
├── Add sources to a notebook
│   ├── URL / YouTube ────────────► source_add(type=url)
│   ├── Plain text ───────────────► source_add(type=text)
│   ├── Local file ───────────────► source_add(type=file)
│   ├── Google Drive ─────────────► source_add(type=drive)
│   ├── Rename a source ──────────► source_rename
│   └── Manage sources ──────────► rules/setup-quickstart.md
│
├── Query a notebook (AI chat)
│   ├── Ask questions ────────────► notebook_query
│   └── Configure chat style ────► chat_configure
│
├── Generate studio content
│   ├── 10 artifact types ───────► rules/workflow-studio-content.md
│   ├── Revise slides ───────────► studio_revise (creates new deck)
│   └── Export to Docs/Sheets ──► export_artifact
│
├── Research & discovery
│   └── Web/Drive research ──────► rules/workflow-research-discovery.md
│
├── Notes (capture insights)
│   └── Create/list/update/delete ► note (unified tool)
│
├── Sharing & collaboration
│   └── Public links / invites / batch ► rules/workflow-sharing-collaboration.md
│
├── Batch & cross-notebook
│   ├── Query across notebooks ────► cross_notebook_query
│   ├── Bulk operations ───────────► batch (query, add-source, create, studio)
│   └── Multi-step pipelines ──────► rules/workflow-batch-pipelines.md
│
├── Organization
│   └── Tag notebooks ─────────────► tag
│
└── Workflow patterns
    ├── Second brain ─────────────► rules/workflow-second-brain.md
    ├── Research offload ─────────► rules/workflow-research-offload.md
    └── Knowledge base ──────────► rules/workflow-knowledge-base.md

クイックリファレンス

カテゴリ	ルール	影響度	主なパターン
セットアップ	setup-quickstart.md	高	認証、MCP 設定、ソース管理、セッションの更新
ワークフロー	workflow-second-brain.md	高	意思決定文書、プロジェクトハブ、エージェント間の相互運用
ワークフロー	workflow-research-offload.md	高	統合、オンボーディング、トークンの節約
ワークフロー	workflow-knowledge-base.md	高	デバッグ用ナレッジベース、セキュリティハンドブック、チームの知識
ワークフロー	workflow-studio-content.md	高	10 種類のアーティファクト（音声、シネマティック動画、スライド、インフォグラフィック、マインドマップなど）
リサーチ	workflow-research-discovery.md	高	ウェブ／Drive のリサーチにおける非同期フロー
コラボレーション	workflow-sharing-collaboration.md	中	公開リンク、共同作業者への招待、一括共有
一括処理	workflow-batch-pipelines.md	高	ノートブックをまたぐクエリ、一括操作、パイプライン
リリース	workflow-versioned-notebooks.md	高	変更履歴と差分を含む、リリースごとのノートブック

合計：5 カテゴリにわたる 9 つのルール

API グループ別 MCP ツール

グループ	ツール	数
ノートブック	notebook_list, notebook_create, notebook_get, notebook_describe, notebook_rename, notebook_delete	6
ソース	source_add, source_rename, source_list_drive, source_sync_drive, source_delete, source_describe, source_get_content	7
クエリ	notebook_query, chat_configure	2
Studio	studio_create, studio_status（ほかに list_types, rename）	4
リサーチ	research_start, research_status, research_import	3
共有	notebook_share_status, notebook_share_public, notebook_share_invite, notebook_share_batch	4
メモ	note（統合：list/create/update/delete）	1（4 アクション）
ダウンロード	download_artifact	1
エクスポート	export_artifact（Google Docs/Sheets）	1
バッチ	batch（複数ノートブック操作）、cross_notebook_query	2
パイプライン	pipeline（アクション：run|list；ingest-and-podcast、research-and-report、multi-format）	1
タグ	tag（アクション：add|remove|list|select）	1
認証	save_auth_tokens, refresh_auth, server_info	3

合計：13 グループにわたる 36 個のツール（v0.6.1+）

主な判断基準

判断	推奨
新規ノートブックと既存ノートブック	プロジェクト／トピックごとにノートブックを 1 つ作成し、既存のものにソースを追加します
ソースの種類	ウェブには URL、インラインテキストには text、ローカル文書には file、Google Docs には drive を使用します
大きなソース	検索精度を高めるため、50K 文字を超えるソースは複数に分割します
認証の期限切れ	nlm login --check を実行します。セッションは約 20 分間有効です。再認証には nlm login を実行します
Studio コンテンツ	studio_create を使用し、studio_status で状態を確認します（生成には 2～5 分かかります）
シネマティック動画	studio_create(artifact_type="video", video_format="cinematic") — Plus/Ultra が必要です。英語のみ、1 日 20 本までです
音声形式	audio_format で brief/critique/debate/deep_dive を選び、audio_length で short/default/long を選択します
リサーチによる発見	ウェブ／Drive の検索には research_start を使用し、その後 research_import を実行します（デフォルトのタイムアウトは 300 秒です）
詳細なリサーチ	複数ソースの統合には research_start(mode="deep") を使用します（v0.5.1+、自動再試行）
リリース用ノートブック	マイナーバージョンごとにノートブックを 1 つ作成し、CHANGELOG と主要なスキルの差分をソースとしてアップロードします
クエリと検索	AI に基づく回答には notebook_query、生テキストには source_get_content を使用します
メモとソース	自分の知見や注釈にはメモ、外部文書にはソースを使用します
インフォグラフィックのスタイル	studio_create の infographic_style パラメーターで 11 種類のビジュアルスタイルを指定できます
スライドの修正	個々のスライドを編集するには studio_revise を使用します（新しいデッキが作成されます）
アーティファクトのエクスポート	export_artifact はレポートを Google Docs に、データテーブルを Sheets に送信します
言語	studio_create の language パラメーターは BCP-47 コード（例：ヘブライ語の he、en、es、ja）を受け付けます
ソースの一括追加	複数 URL の取り込みと処理完了待機には source_add(urls=["url1","url2"], wait=True) を使用します
バッチ操作	複数ノートブックの操作には batch、集約した回答には cross_notebook_query を使用します
パイプライン	複数ステップのワークフローには pipeline(action="run", pipeline_name="ingest-and-podcast") を使用します

例

# 1. Create a notebook for your project
notebook_create(title="Auth Refactor Research")

# 2. Add sources (docs, articles, existing code analysis)
source_add(notebook_id="...", type="url", url="https://oauth.net/2.1/")
source_add(notebook_id="...", type="text", content="Our current auth uses...")
source_add(notebook_id="...", type="file", path="/docs/auth-design.md")

# 3. Query with grounded AI responses
notebook_query(notebook_id="...", query="What are the key differences between OAuth 2.0 and 2.1?")

# 4. Generate a deep dive audio overview (supports language param)
studio_create(notebook_id="...", artifact_type="audio", audio_format="deep_dive", language="he", confirm=True)
studio_status(notebook_id="...")  # Poll until complete

# 5. Generate a cinematic video overview (Plus/Ultra, English)
studio_create(notebook_id="...", artifact_type="video", video_format="cinematic", visual_style="classic", confirm=True)
studio_status(notebook_id="...")  # Poll — takes 3-8 minutes

# 6. Capture insights as notes
note(notebook_id="...", action="create", content="Key takeaway: PKCE is mandatory in 2.1")

よくある間違い

• 認証の有効期限を忘れる — セッションは約20分間有効です。長時間のワークフローを実行する前に、必ず nlm login --check で確認してください。再認証するには nlm login を実行してください。
• 巨大なノートブックを1つだけ使う — プロジェクトやトピックごとに分けてください。ソースが50個あるノートブックを1つだけ使うと、検索品質が低下します。
• 単一ソースが大きすぎる — 50K文字を超えるドキュメントは、チャンク分割と検索の品質を高めるため、論理的なセクションに分割してください。
• studio_statusをポーリングしない — Studioのコンテンツ生成には2〜5分かかります。結果がすぐに得られると思い込まず、studio_status をポーリングしてください。
• ソースの種類を無視する — ウェブページには type=url（自動抽出）、ローカルファイルには type=file を使用してください。URLに type=text を使用すると、ページの内容ではなくURL文字列が取得されます。
• 確認せずにノートブックを削除する — notebook_delete は取り消せません。まず source_list_drive と note(action=list) で内容を一覧表示してください。
• research_importを省略する — research_start はコンテンツを見つけますが、追加はしません。調査結果をソースとして実際に追加するには、research_import を使用してください。
• 空のノートブックにクエリを実行する — ソースがない状態で notebook_query を実行しても、質の低い結果しか得られません。クエリを実行する前にソースを追加してください。
• languageパラメーターを無視する — studio_create はBCP-47の language コード（例：he、ar、ja）に対応しています。省略すると、デフォルトで英語になります。
• 目的なくバッチ処理を行う — batch と cross_notebook_query は強力ですが、遅延が増えます。単一ノートブックのタスクではなく、複数プロジェクトの統合に使用してください。

関連スキル

• ork:mcp-patterns — MCP サーバーの構築、セキュリティ、構成パターン
• ork:web-research-workflow — ウェブ調査の戦略とソースの評価
• ork:memory — セッションをまたいだナレッジの永続化を実現するメモリファブリック
• ork:security-patterns — 入力のサニタイズと多層セキュリティ