notebooklm-mcp

NotebookLM（Gemini Notebook）— CLI + MCP

Google NotebookLM には公式 API がありません。notebooklm-mcp-cli パッケージ（nlm CLI + notebooklm-mcp サーバー）は、ログイン済みの Google セッションからブラウザーの Cookieを抽出してキャッシュする、サードパーティ製の非公式クライアントです。このスキルでは、ヘッドレス環境に適した 2 つの認証方法と、MCP サーバーの設定を説明します。

セキュリティに関する注意：cookies.txt ファイルまたはキャッシュされた auth.json は、Google セッションと同等のものです。エージェントは、ユーザーの明示的な同意なしに Cookie の値を抽出、読み取り、転送してはいけません。

パス	バイナリ	トランスポート	使用する場面
A. CLI	nlm	shell	シェルにアクセスできるすべてのエージェント。ノートブック、ソース、ノート、チャット、スタジオをすべて管理できます。
B. MCP	notebooklm-mcp	stdio（または http/sse）	MCP ネイティブのエージェント（Claude Code、Cursor、Devin、Gemini CLI）。約 30 個のツール（notebook_create、source_add、chat、audio、report など）を公開します。

どちらのパスも、~/.notebooklm-mcp-cli/profiles/<profile>/auth.json にある同じ Cookie キャッシュを共有します。

使用する場面

• devin mcp list / claude mcp list で、notebooklm-mcp のツール一覧の取得に失敗と表示される場合。

• nlm login --check が ClientAuthenticationError または network_error で失敗する場合。

• nlm doctor が「Browser: not found」（ヘッドレスサーバー）を報告する場合。

• デスクトップブラウザーのないサーバーで NotebookLM を認証したい場合。

• Claude Code / Cursor / Devin / Gemini 向けの NotebookLM MCP サーバーの設定を依頼された場合。

• Google Cookie を手動で抽出する必要がある場合、または外部 CDP エンドポイント経由で認証する必要がある場合。

• ユーザーが英語でこのスキルを依頼または言及した場合（例：「use /notebooklm-mcp」「run notebooklm-mcp」）。

• ユーザーがポルトガル語でこのスキルを依頼または言及した場合（例：「use /notebooklm-mcp」「execute notebooklm-mcp」）。

使用しない場面

• ユーザーが汎用的な「Google ドキュメントをスクレイピングする」ツールを求めている場合。NotebookLM は NotebookLM 製品専用です。
• Chrome がインストールされたデスクトップを使用している場合。nlm login（自動モード）を実行するだけでよく、このスキルは必要ありません。

ガードレール

• ユーザー自身によるインストール：エージェントは notebooklm-mcp-cli をインストールまたはアップグレードしません。nlm／notebooklm-mcp が PATH にない場合は処理を停止し、以下のインストール用ブロックをユーザーに提示します。ユーザーが内容を確認して実行します。明示的にバージョンを固定した ==<VERSION> を推奨し、バージョン指定のないインストールは決して行いません。
• ユーザーがインストールする前に上流を確認する：PyPI と上流のソースでパッケージ名とバージョンを確認します。これは非公式クライアントとして扱ってください。
• すべての認証方法で人間による確認が必要：Cookie の抽出、ファイルのインポート、管理対象ブラウザーの CDP エンドポイントの使用を行う前に、エージェントはユーザーから明示的な同意を得る必要があります。
• Cookie の自動収集は禁止：バックグラウンドで、またはユーザーが明示的に許可していないブラウザーから Cookie を抽出してはいけません。
• Cookie は認証情報です：cookies.txt ファイルまたはキャッシュされた auth.json は Google セッションと同等です。決してコミット、共有、ログへの記録、スクリーンショットの撮影、クリップボードへのコピー、送信をしてはいけません。
• Cookie ファイルは直ちに削除する：nlm login --manual --file が成功したら、すぐに cookies.txt を削除します。/tmp、プロジェクトディレクトリ、共有場所に残してはいけません。
• 認証情報の仲介は禁止：nlm login はブラックボックスコマンドとして実行します。cookies.txt や auth.json の内容を読み取ったり、解析したり、転送したりしてはいけません。
• 公式の認証方法を優先する：ブラウザーを利用できる場合は、デスクトップで nlm login の自動モードを使用します。手動 Cookie モードは、ユーザーが管理するヘッドレスサーバーでのみ使用してください。
• ブラウザーデータの収集は禁止：ユーザー自身のブラウザーセッションからのみ Cookie を抽出します。抽出した Cookie は nlm の認証以外の目的に使用してはいけません。
• 信頼する前に検証する：ノートブックを操作する前に、nlm login --check と nlm doctor を実行します。
• 特権操作は禁止：ユーザーが明示的に要求し、その理由を確認しない限り、昇格した権限（sudo）または root として nlm を実行してはいけません。
• 認証キャッシュを分離する：複数のユーザーが環境にアクセスする可能性がある場合は、共有のデフォルトプロファイルではなく、プロジェクトごとまたはプロファイルごとの認証を優先してください。
• アカウントのリスクを開示する：nlm は非公式クライアントであり、Google の利用規約に違反する可能性があります。使用するアカウントはレート制限または停止の対象となることがあります。このリスクを伝え、予備または専用の Google アカウントの使用を推奨してください。警告なしにユーザーのメインアカウントを使わせてはいけません。
• セッションの適用範囲：インポートされた Cookie は NotebookLM の範囲を大きく超える、完全な Google ウェブセッションを付与します。auth.json／cookies.txt は NotebookLM 専用のトークンではなく、アカウント全体の認証情報として扱ってください。
• データの機密性：ノートブックに追加されたもの（ソース、ファイル、チャットプロンプト）はすべて Google に送信されます。秘密情報、認証情報、PII をソースやプロンプトとして追加してはいけません。内容が確認されていないファイルをアップロードする前に、ユーザーに確認してください。
• MCP トランスポートの適用範囲：stdio（ローカルエージェントのみ）を優先します。ユーザーが明示的に要求した場合に限り、--transport http／sse を使用します。localhost にバインドし、リモートに公開する前に TLS と認証に対応したリバースプロキシを必須としてください。

---

インストール（エージェントではなくユーザーが実行）

notebooklm-mcp-cli はサードパーティの PyPI 配布物です。エージェントはこれをインストールしてはいけません。nlm／notebooklm-mcp が存在しない場合は、以下のブロックをそのまま提示し、ユーザー自身が実行するまで待ちます。

バージョンを指定してください。<VERSION> を、ユーザーが PyPI で確認した安定版（例：pip index versions notebooklm-mcp-cli）に置き換えます。

# Option 1: uv (recommended)
uv tool install notebooklm-mcp-cli==<VERSION>

# Option 2: pipx
pipx install notebooklm-mcp-cli==<VERSION>

# Option 3: pip (only in a virtual environment; avoid --user)
pip install notebooklm-mcp-cli==<VERSION>

確認：

nlm --version          # 0.9.x
which nlm notebooklm-mcp

診断はいつでも実行できます：

nlm doctor             # checks install, auth, browser, AI-tool configs
nlm doctor -v          # verbose

---

認証

NotebookLM には API キーがありません。サポートされている認証方法は、ブラウザーを使えるマシンで nlm login を実行することです。ユーザーがヘッドレス環境向けの代替手段を明示的に求め、その方法を確認しない限り、エージェントは Google のセッション Cookie を抽出、読み取り、転送してはなりません。

方法	コマンド	必要なもの	最適な用途
デスクトップ自動ログイン（推奨）	nlm login	デスクトップ／サーバーのブラウザー（Chrome/Chromium/Brave/Edge/Arc/Firefox）	デフォルト — ブラウザーが利用できる場合は常に推奨
OpenClaw CDP	nlm login --provider openclaw --cdp-url http://127.0.0.1:18800	Google にログイン済みの OpenClaw 管理ブラウザー	ユーザーが OpenClaw を実行し、CDP エンドポイントを確認した場合
手動 Cookie ファイル	nlm login --manual --file cookies.txt	ユーザーから提供された cookies.txt ファイル	ユーザーが管理するヘッドレスサーバーでの緊急時の代替手段
デスクトップ自動ログイン＋auth.json のコピー	デスクトップで nlm login を実行し、その後 ~/.notebooklm-mcp-cli/profiles/<profile>/auth.json をコピー	ブラウザーを備えたデスクトップ	ユーザー自身がキャッシュ済みの認証ファイルを明示的にコピーする場合

ヘッドレス環境での代替手段の優先順位： （1）デスクトップ自動ログインを行い、ユーザーが auth.json をコピー、（2）ユーザーが管理するブラウザーで OpenClaw CDP を使用、（3）緊急時のみ手動 Cookie ファイルを使用。

デスクトップ自動ログイン

対応ブラウザーを使えるデスクトップまたはサーバーで実行します。

nlm login              # launches a dedicated browser profile; the user logs in
nlm login --check

特定のブラウザーを指定する場合：

nlm config set auth.browser chromium   # or brave, arc, edge, chrome, firefox, vivaldi, opera

エージェントが自律的に実行すべき認証方法はこれだけです。

OpenClaw CDP（ユーザーの承認が必要）

nlm login --provider openclaw --cdp-url http://127.0.0.1:18800

異なる CDP ポートを使用するカスタム OpenClaw ブラウザープロファイルを設定した場合：

# Check your OpenClaw browser config
openclaw config get browser.profiles

# Use the matching CDP port
nlm login --provider openclaw --cdp-url http://127.0.0.1:<port>

OpenClaw ブラウザーは、すでに Google／NotebookLM にログインしている必要があります。デフォルトの Origin ヘッダーを拒否する管理対象エンドポイントに対応するため、WebSocket CDP コマンドには suppress_origin=True を使用します。

方法 1 — 手動 Cookie ファイル（緊急時の代替手段のみ）

エージェントはこれらの手順を自動的に実行してはなりません。 手動での Cookie 抽出は、ユーザーが管理するヘッドレスサーバー向けの緊急時の代替手段です。ユーザー自身が cookies.txt を作成し、インポート直後に削除する必要があります。

手順 1：ユーザーが Chrome を使えるマシンで Cookie を抽出する

1. Chrome を開き、https://notebooklm.google.com にアクセスします。
2. Google アカウントにログインしていることを確認します。
3. F12（Mac の場合は Cmd+Option+I）を押して DevTools を開きます。
4. Network タブをクリックします。
5. フィルターボックスに batchexecute と入力します。
6. 任意のノートブックをクリックして、リクエストを発生させます。
7. リスト内の batchexecute リクエストをクリックします。
8. 右側のパネルで Request Headers までスクロールします。
9. cookie: で始まる行を見つけます。
10. Cookie の値を右クリックし、Copy value を選択します。
11. テキストファイルに貼り付け、cookies.txt として保存します。

Cookie ファイルの形式

ファイルには、Chrome DevTools から取得した生の Cookie 文字列を含めます。

SID=abc123...; HSID=xyz789...; SSID=...; APISID=...; SAPISID=...; __Secure-1PSID=...; __Secure-3PSID=...; ...

• # で始まる行はコメントとして扱われ、無視されます。
• Cookie 文字列は、1 行または複数行に記述できます。

手順 2：サーバーにインポートする

# The user copies cookies.txt to the server, then:
nlm login --manual --file cookies.txt

# Delete the cookie file immediately after successful import
shred -u cookies.txt 2>/dev/null || rm -f cookies.txt

手順 3：確認する

nlm login --check
# ✓ Authenticated as [email protected]

nlm doctor
# Authentication: cookies present, CSRF token: yes, account: [email protected]

トークンは ~/.notebooklm-mcp-cli/profiles/default/auth.json にキャッシュされます。

方法 2 — OpenClaw CDP プロバイダー

OpenClaw が管理するブラウザーがすでに起動しており、Chrome DevTools Protocol エンドポイントを公開している場合、nlm は 2 つ目のブラウザーを起動せずに Cookie を読み取れます。

nlm login --provider openclaw --cdp-url http://127.0.0.1:18800

• デフォルトの Origin ヘッダーを拒否する管理対象エンドポイントに対応するため、WebSocket CDP コマンドには suppress_origin=True を使用します。
• ブラウザーは、すでに Google／NotebookLM にログインしている必要があります。
• エンドポイントの応答が遅い場合は、DevTools のタイムアウトを延長します：nlm login --provider openclaw --cdp-url http://127.0.0.1:18800 --devtools-timeout 15

同じ方法で確認します。

nlm login --check

方法 3 — 自動モード（ブラウザーを備えたデスクトップ）

Chrome/Chromium/Brave/Edge/Arc/Firefox がインストールされたデスクトップで実行します。

nlm login              # launches a dedicated browser profile, you log in, cookies extracted

特定のブラウザーを指定する場合：

nlm config set auth.browser chromium   # or brave, arc, edge, chrome, firefox, vivaldi, opera

マルチプロフィール認証

名前付きプロフィールを使用して、複数の Google アカウントを利用できます。

nlm login --profile work
nlm login --profile personal
nlm login switch work
nlm login profile list
nlm login profile delete personal

MCP サーバーは常にアクティブなデフォルトプロフィールを使用します。デフォルトプロフィールを切り替えると、MCP サーバーが使用する Google アカウントも即座に切り替わります。

nlm login switch personal
nlm config set auth.default_profile personal

認証のライフサイクル

コンポーネント	有効期間	更新
Cookie	約2～4週間	（プロフィールが保存されている場合）ヘッドレスブラウザーで自動更新
CSRF トークン	数分	リクエスト失敗のたびに自動更新
セッション ID	セッション期間	Cookie に埋め込み

Cookie の有効期限が切れた場合：

nlm login --check        # reports stale/unverified
nlm login                # re-extract (auto mode)
nlm login --manual --file cookies.txt   # re-extract (manual mode)

認証セキュリティチェックリスト

認証操作を行う前に、以下のすべての項目を確認してください。不明な点がある場合は中止し、ユーザーに確認してください。

• ユーザーがこの認証方法を明示的に要求し、Google セッション Cookie を使用することを理解しています。
• 対象のマシンはユーザーが管理しています（個人のワークステーション、またはユーザーが管理するサーバー）。
• Cookie ファイルはコミット、ログへの記録、クリップボードへのコピーを行わず、インポート後にディスク上に残しません。
• --provider openclaw を使用する場合、CDP エンドポイントはユーザー自身の OpenClaw 管理ブラウザーです。
• --manual --file cookies.txt を使用する場合、ユーザーがファイルを提供し、インポート後に削除します。
• ノートブック操作を行う前に、nlm login --check と nlm doctor が成功します。

---

PATH A — CLI の使用

# Notebooks
nlm notebook list
nlm notebook create --title "My Notebook"
nlm notebook get <notebook_id>
nlm notebook delete <notebook_id>

# Sources
nlm source add <notebook_id> --url https://example.com/doc
nlm source add <notebook_id> --file ./paper.pdf
nlm source list <notebook_id>

# Notes
nlm note add <notebook_id> --text "My note"
nlm note list <notebook_id>

# Chat
nlm chats start <notebook_id>
nlm chats send <notebook_id> "Summarize the sources"

# Audio overviews
nlm audio create <notebook_id>
nlm download <notebook_id> --artifact audio

# Reports
nlm report create <notebook_id> --topic "Key findings"

# Research
nlm research discover "climate adaptation strategies"

# Batch + cross-notebook
nlm batch <notebook_ids_file> --command "summarize"
nlm cross query "find mentions of X across all notebooks"

# Tags + labels
nlm tag add <notebook_id> research
nlm label add <notebook_id> source_1 priority

# Sharing + export
nlm share <notebook_id> --email [email protected]
nlm export <notebook_id> --format docs

# Diagnostics
nlm doctor
nlm doctor auth-replay     # diagnose cookie replay vs browser-bound auth failures

---

PATH B — MCP サーバー

B.1 設定

最も簡単な方法は nlm setup を使用することです（Claude Code、Claude Desktop、Cursor、Gemini CLI、GitHub Copilot、Windsurf に対応しています）。

nlm setup add claude-code       # Claude Code
nlm setup add claude-desktop    # Claude Desktop
nlm setup add gemini            # Gemini CLI / Antigravity IDE
nlm setup add github-copilot    # GitHub Copilot
nlm setup add cursor            # Cursor
nlm setup add windsurf          # Windsurf
nlm setup add json              # Any other tool (interactive JSON generator)

nlm setup list                  # show supported tools + their MCP config status

nlm setup が対応していないプラットフォーム（Devin CLI/Desktop、OpenCode、Antigravity CLI、OpenClaw）では、同梱のセットアップスクリプトを使用するか、設定を手動で編集してください。

プラットフォームごとの設定 — 重大な注意点

MCP クライアントのプラットフォームごとに、設定形式が異なります。フィールド名を間違えると、サーバーは警告なしに無視されます（エラーは出ず、ツールも表示されません）。全プラットフォームの一覧については、references/platform-quirks.md を参照してください。

プラットフォーム	設定ファイル	ルートキー	Stdio コマンド	注意点
Claude Code	~/.claude.json	mcpServers	command + args	type: "stdio"
Claude Desktop	claude_desktop_config.json	mcpServers	command + args	—
Cursor	~/.cursor/mcp.json	mcpServers	command + args	type: "stdio" が必須
Devin CLI	~/.config/devin/mcp_config.json	mcpServers	command + args	devin mcp add CLI
Devin Desktop	~/.devin/mcp_config.json	mcpServers	command + args	—
OpenCode	~/.config/opencode/opencode.json	mcp	command（単一配列）	type: "local"、env ではなく environment
Antigravity IDE/CLI	~/.gemini/config/mcp_config.json	mcpServers	command + args	アンインストール時にキャッシュを消去
OpenClaw	OpenClaw の設定	mcp.servers	command + args	openclaw mcp add CLI

警告なしに失敗する主な原因トップ3：

1. OpenCode は mcp（mcpServers ではありません）、environment（env ではありません）、単一配列の command（バイナリと引数を結合）を使用します。
2. OpenClaw は transport: "stdio" を指定した mcp.servers（ドット区切り）を使用します。openclaw mcp add/set で管理します。
3. Antigravity は MCP サーバーを ~/.gemini/antigravity{,-ide,-cli}/mcp/ にキャッシュするため、アンインストールするにはキャッシュディレクトリを削除する必要があります。

プラットフォームごとの正確な JSON ブロックについては、references/mcp-config.md を参照してください。

自動セットアップヘルパー

同梱のヘルパーを実行すると、インストール済みのすべてのプラットフォームを検出し、それぞれに正しい形式の設定を適用できます。

bash skills/notebooklm-mcp/scripts/setup_notebooklm_mcp.sh
# dry-run:
bash skills/notebooklm-mcp/scripts/setup_notebooklm_mcp.sh --dry-run
# target one platform:
bash skills/notebooklm-mcp/scripts/setup_notebooklm_mcp.sh --platform cursor
# use bare notebooklm-mcp binary instead of nlm wrapper:
bash skills/notebooklm-mcp/scripts/setup_notebooklm_mcp.sh --binary notebooklm-mcp
# remove:
bash skills/notebooklm-mcp/scripts/setup_notebooklm_mcp.sh --remove

トランスポートのオプション

notebooklm-mcp                          # stdio (default, for local agents)
notebooklm-mcp --transport http --port 8000   # HTTP (for remote agents)
notebooklm-mcp --transport sse  --port 8000   # SSE

環境変数：

変数	説明
NOTEBOOKLM_MCP_TRANSPORT	トランスポートの種類（stdio/http/sse）
NOTEBOOKLM_MCP_PORT	HTTP/SSE ポート
NOTEBOOKLM_MCP_DEBUG	詳細ログを有効にする
NOTEBOOKLM_HL	インターフェースの言語／ロケール（例：pt-BR、es-419）
NOTEBOOKLM_QUERY_TIMEOUT	クエリのタイムアウト（秒）
NOTEBOOKLM_BASE_URL	Enterprise/Workspace 用のベース URL を上書きする

リモート MCP に関する警告： HTTP トランスポートでは、HTTPS、呼び出し元の認証、ユーザーごとの NotebookLM アカウント、リモートファイル転送は提供されません。TLS と認証を追加するリバースプロキシを経由せずに、公開しないでください。

B.2 確認

設定後、エージェントを再起動してください。MCP サーバーは約 30 個のツールを公開します。エージェントから確認してください。

mcp_list_tools("notebooklm-mcp")
# Expect: notebook_create, notebook_list, source_add, source_list, chat_send,
#         audio_create, report_create, refresh_auth, save_auth_tokens, ...

シェルから：

bash skills/notebooklm-mcp/scripts/verify_notebooklm.sh

B.3 MCP 経由で公開される認証ツール

ツール	説明
refresh_auth	キャッシュされたプロファイルから認証トークンを再読み込みする
save_auth_tokens	Cookie を保存する（代替方法）

MCP ツールの呼び出しが認証エラーで失敗した場合は、まず refresh_auth を呼び出してください。それでも失敗する場合は、ホスト上で nlm login を再実行してください。

---

ヘッドレス認証フロー（判断図）

┌────────────────────────────────────────────────────────────────┐
│ Is an OpenClaw browser running with CDP on 127.0.0.1:18800?    │
│   YES → nlm login --provider openclaw --cdp-url http://...     │
│   NO  ↓                                                        │
│ Do you have a cookies.txt file (extracted on another machine)? │
│   YES → nlm login --manual --file cookies.txt                  │
│   NO  ↓                                                        │
│ Can you run nlm login on a desktop with Chrome?                │
│   YES → nlm login (auto mode) → copy auth.json to the server   │
│         (cp ~/.notebooklm-mcp-cli/profiles/default/auth.json   │
│            server:~/.notebooklm-mcp-cli/profiles/default/)     │
│   NO  → cannot authenticate; NotebookLM needs Google cookies   │
└────────────────────────────────────────────────────────────────┘

---

トラブルシューティング

症状	原因	対処方法
nlm login --check → ClientAuthenticationError	Cookie の期限切れ、または無効	再抽出する：nlm login --manual --file cookies.txt または nlm login
nlm doctor → "Browser: not found"	ヘッドレスサーバーで、Chrome がない	手動ファイルモードまたは OpenClaw CDP を使用する（認証セクションを参照）
nlm doctor → "Headless auth: not available"	保存済みのブラウザープロファイルがない	デスクトップで nlm login を一度実行してプロファイルを保存するか、手動モードを使用する
MCP ツールが認証エラーで失敗する	キャッシュされた Cookie が古い	refresh_auth MCP ツールを呼び出すか、ホスト上で nlm login を実行する
--check で network_error が発生する	Cookie は存在するが、セッションが無効	再ログインする。保存済みの認証情報は引き続き有効な場合がありますが、セッションの期限が切れています
Gemini Notebook サーバーが 2 つ設定されている	ツール名の重複により、エージェントが混乱する	レガシーサーバーを削除し、notebooklm-mcp のみを残す
nlm setup add <tool> が "already configured" と表示する	既存のエントリーがある	nlm setup remove <tool> を実行してから再追加するか、設定を手動で編集する
Cookie の再利用に失敗する（ブラウザーに紐づいた認証）	Google がブラウザーに紐づいたセッションを要求している	nlm doctor auth-replay を実行して診断する。実際のブラウザーを使った自動モードが必要な場合があります

---

参考資料

• references/mcp-config.md — プラットフォームごとの完全な JSON 設定ブロック（Claude Code/Desktop、Cursor、Devin CLI/Desktop、OpenCode、Antigravity IDE/CLI、OpenClaw）。
• references/platform-quirks.md — プラットフォーム間の MCP 設定の違いをまとめた表（serverUrl と url、mcp と mcpServers、environment と env、環境変数の置換構文、OpenClaw の CDP ポート）。
• references/auth-guide.md — Cookie の抽出、ファイル形式、複数プロファイル、OpenClaw CDP、認証のライフサイクルについての詳細な解説。
• scripts/setup_notebooklm_mcp.sh — インストール済みのすべてのプラットフォームを検出し、それぞれに適切な形式で設定を適用します（mcp/mcpServers、command 配列、environment/env、OpenClaw CLI に対応）。
• scripts/verify_notebooklm.sh — nlm doctor と nlm login --check を実行し、ノートブックを一覧表示して、最初から最後まで正常に動作することを確認します。
• scripts/extract_cookies_help.sh — Cookie を抽出するための手順をステップごとにユーザーに表示します。
• 認証ガイド（上流）
• MCP ガイド（上流）
• CLI ガイド（上流）
• PyPI
• Devin CLI MCP の設定
• Antigravity MCP のドキュメント
• OpenCode MCP サーバー
• OpenClaw MCP ツール
• OpenClaw ブラウザー CDP
• Cursor MCP のドキュメント