nblm-mcp

AIエージェントにGoogle NotebookLM（2026年7月にGemini Notebookへ改名）へのアクセスを提供するMCPサーバーです。ノートブックの一覧表示・作成、ソースの管理、それらのソースからの引用付き回答を得る質問、オーディオ概要・ブリーフィングドキュメント・クイズ・マインドマップなどのStudioアーティファクト生成を行います。

ポイントは「根拠に基づくこと」です。NotebookLMは与えた素材だけから回答するため、askを呼び出せるエージェントは、推測ではなく自分のドキュメントから引用付きの回答を得られます。しかも、Geminiがサーバー側で読むため、自分のコンテキストのトークンを消費しません。

⚠️ 非公式 — 最初にお読みください

GoogleにはNotebookLMの公開コンシューマーAPIはありません。 このサーバーは、notebooklm.google.comのUIが呼び出すのと同じ非公開Webエンドポイントを、MITライセンスのnotebooklm-pyライブラリを介して、自分のブラウザセッションCookieで認証して操作します。

• Googleとは提携・承認されていません。

• 内部APIは予告なく変更され、このサーバーが壊れる可能性があります。

• Googleアカウントのレート制限と1日のStudioクォータが適用されます。

• 自動化しても問題ないアカウントを使用してください。個人プロジェクト、研究、プロトタイプに最適です。

GoogleはGemini Notebook Enterprise向けの公式APIを文書化しています。その機能を持つWorkspace/Cloud組織をお持ちの場合は、こちらを優先してください。

インストール

まだPyPIには公開されていません — このリポジトリから直接インストールします。uvxが必要に応じてビルドして実行するため、手動で更新するものはありません:

uvx --from git+https://github.com/Diego-Dev-Moros/nblm-mcp nblm-mcp

Related MCP server: NotebookLM MCP Server

一度ログインする

ログインにはauthエクストラ（Playwright）とキーボードの前の人間が必要です:

uvx --from "nblm-mcp[auth] @ git+https://github.com/Diego-Dev-Moros/nblm-mcp" nblm-mcp-login

ブラウザウィンドウが開くので、通常どおりNotebookLMにサインインします。セッションCookieは~/.notebooklm/に保存されます（notebooklm-pyが使用するのと同じプロファイル構成なので、既存のnotebooklm loginも機能します）。MCPサーバーは単独ではログインしません — インタラクティブなブラウザが必要であり、MCPホストはそれを提供できないためです。

Playwrightにブラウザがまだない場合は、最初にplaywright install chromiumを実行してください。

Cookieは期限切れになります。期限が切れると、ツールは認証エラーを返し始めるので、ログインコマンドを再度実行してください。

クライアントに接続する

Claude Code — -s userを指定すると、すべてのプロジェクトで利用可能になります:

claude mcp add notebooklm -s user -- \
  uvx --from git+https://github.com/Diego-Dev-Moros/nblm-mcp nblm-mcp

Claude Desktop — これをclaude_desktop_config.jsonに追加してアプリを再起動します（macOS: ~/Library/Application Support/Claude/、Windows: %APPDATA%\Claude\、Linux: ~/.config/Claude/）:

{
  "mcpServers": {
    "notebooklm": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Diego-Dev-Moros/nblm-mcp", "nblm-mcp"]
    }
  }
}

Claude DesktopはGUIから起動するため、シェルのPATHを継承しません。そこでサーバーが起動しない場合は、"uvx"を絶対パス（which uvx、通常は~/.local/bin/uvx）に置き換えてください。

どちらの場合も、エージェントにauth_statusを呼び出させることで動作を確認できます。

ツール

動作に関する注意

• 破壊的なツールはゲート付きです。 delete_notebookとdelete_sourceはconfirm=trueなしでは実行を拒否するため、誤ったツール呼び出しでノートブックを破壊することはありません。

• 生成は遅く、クォータに制限されます。 generate_artifactはジョブがキューに入るとすぐに返り（wait=false、デフォルト）、エージェントにlist_artifactsをポーリングするよう指示します。代わりにブロックするにはwait=trueを渡します。NBLM_GENERATION_TIMEOUT秒まで待機します。

• ファイルパスはサーバー側です。 add_source(file_path=...)とdownload_artifactは、MCPサーバーが実行されているホスト上で読み書きします。これはユーザーのチャットクライアントが実行されている場所と同じとは限りません。

設定

すべてオプションです — .env.exampleを参照してください。作業ディレクトリに.envがあれば読み込まれます。

開発

uv venv && uv pip install -e ".[dev]"
uv run pytest
uv run ruff check src tests

テストスイートはインメモリのフェイククライアントに対してツールを実行します — Googleには一切アクセスしないため、どこでも安全かつ高速に実行できます。

先行技術

notebooklm-pyが難しい部分 — 非公開のbatchexecuteプロトコルのリバースエンジニアリングと保守 — を担当し、独自のより大きなMCPサーバーを提供しています。このプロジェクトは、そのライブラリの上に構築された、より小さく、意見が反映されたツールサーフェスです。ツールが少なく、破壊的操作には確認ゲートがあり、引用が解決された回答を提供します。

ライセンス

MIT — LICENSEを参照してください。