NotebookLM MCP Server

用于 Google NotebookLM 的 MCP Server。它通过 Patchright（具备隐身与持久化指纹特征）驱动真实的 Chrome 浏览器，使 AI Agent 能够针对笔记本进行对话、摄入源文件、生成音频概览，并读取 DOM 级别的引用。支持两种传输方式：stdio（默认）和 Streamable-HTTP。当前版本为 v2.0.0；v1 版本已不再支持。

• 要求与平台支持
• 安装
• 连接至客户端 — Claude Code, Cursor, Codex, 通用 MCP
• 身份验证
• 传输方式
• 多账号支持
• 工具
• 工具配置
• 引用
• 来源与 AI 标记
• 配置参考
• 开发
• 从 v1 迁移

---

要求与平台支持

• Node.js ≥ 18。
• 推荐使用 Chrome（稳定版）。当 Chrome 无法启动时，将使用捆绑的 Patchright Chromium 作为备选方案 —— 设置 BROWSER_CHANNEL=chromium 可强制使用。
• Linux / macOS / Windows。
• 完全支持 WSL2 + WSLg (Windows 11+)。不支持 WSL1，因为它无法启动 Chromium —— 请升级至 WSL2。
• 无头 Linux 服务器：首次执行 setup_auth 时需要显示环境，因为登录流程需要打开可见窗口。请在 xvfb-run 下运行一次（xvfb-run -a npx notebooklm-mcp）。登录完成后，持久化的 Chrome 配置允许后续运行完全在无头模式下进行。

---

安装

已发布包

npx notebooklm-mcp@latest

这是推荐给终端用户的安装方式。npx 会缓存二进制文件并在 @latest 版本更新时自动更新。

从源码安装

git clone https://github.com/PleasePrompto/notebooklm-mcp
cd notebooklm-mcp
npm install
npm run build
node dist/index.js

prepare 脚本会自动运行 npm run build，因此全新的 npm install 即可生成可运行的 dist/index.js。

---

连接至客户端

连接至 Claude Code

CLI 方式：

claude mcp add notebooklm -- npx notebooklm-mcp@latest
# 或者从本地克隆安装:
claude mcp add notebooklm -- node /absolute/path/to/notebooklm-mcp/dist/index.js

手动方式 —— 修改 ~/.claude.json：

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["notebooklm-mcp@latest"]
    }
  }
}

对于本地构建版本，请将 command/args 替换为 "command": "node", "args": ["/absolute/path/to/dist/index.js"]。

---

连接至其他客户端

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["notebooklm-mcp@latest"]
    }
  }
}

Codex CLI

codex mcp add notebooklm npx notebooklm-mcp@latest

通用 MCP 客户端 (stdio)

任何支持通过 stdio 启动 MCP Server 的客户端都可以使用 npx notebooklm-mcp@latest 调用。该服务器支持 MCP 2025 标准以及 SDK 的 Server 能力集（tools, resources, prompts, completions, logging）。

仅支持 HTTP 的客户端 (n8n, Zapier, Make, 托管 Agent)

以 HTTP 模式运行服务器（请参阅传输方式），并对 http://host:port/mcp 发送 POST JSON-RPC 请求。一个简单的 curl 示例位于 docs/usage-guide.md。

---

身份验证

setup_auth 会打开一个可见的 Chrome 窗口，您只需登录一次 Google 账号，Cookie 就会持久保存在用户专属的 Chrome 配置文件中。后续运行将复用该配置文件，无需再次登录。

配置文件位置 (env-paths)：

平台	路径
Linux	~/.local/share/notebooklm-mcp/chrome_profile/
macOS	~/Library/Application Support/notebooklm-mcp/chrome_profile/
Windows	%APPDATA%\notebooklm-mcp\chrome_profile\

身份验证工具：

• setup_auth — 首次登录使用。传入 show_browser=true（设置时的默认值）以显示窗口。启动窗口后立即返回；您有 10 分钟的时间完成登录。
• re_auth — 清除已存储的身份信息并重新开始。在切换 Google 账号或身份验证失效时使用。
• cleanup_data — 进行带分类预览的彻底清理。传入 preserve_library=true 可在清除浏览器状态的同时保留 library.json。

若要在任何浏览器驱动工具中强制显示浏览器，请在调用工具时传入 show_browser=true 或 browser_options.show=true。

---

传输方式

该服务器支持通过 stdio 或 Streamable-HTTP 进行 MCP 通信。

stdio (默认)

npx notebooklm-mcp@latest

Streamable-HTTP

npx notebooklm-mcp@latest --transport http --port 3000