NotebookLM MCP Server

让你的 CLI Agent（Claude、Cursor、Codex 等）直接与 NotebookLM 对话，基于你自己的笔记本获取零幻觉（Zero-hallucination）的答案。

安装 • 快速开始 • 为什么选择 NotebookLM 而非本地 RAG • 实际案例 • Claude Code Skill • 文档

---

问题所在

当你让 Claude Code 或 Cursor “搜索我的本地文档”时，通常会发生以下情况：

• 海量 Token 消耗：搜索文档意味着需要重复读取多个文件。
• 检索不准确：仅基于关键词搜索，容易丢失文档间的上下文与关联。
• 产生幻觉：当找不到相关信息时，它会编造出听起来很像的 API。
• 昂贵且缓慢：每一个问题都需要重新读取多个文件。

解决方案

让你的本地 Agent 直接与 NotebookLM 对话——这是 Google 基于 Gemini 2.5 构建的零幻觉知识库，能够从你的文档中提供智能、经过综合分析的答案。

你的任务 → 本地 Agent 询问 NotebookLM → Gemini 综合生成答案 → Agent 编写正确的代码

真正的优势：无需在 NotebookLM 和编辑器之间手动复制粘贴。你的 Agent 可以直接询问 NotebookLM 并在 CLI 中立即获得回复。它通过自动追问构建深度理解——Claude 可以连续提出多个问题，每个问题都建立在前一个问题之上，从而获得具体的实施细节、边界情况和最佳实践。你可以将 NotebookLM 链接保存到本地库中并添加标签和描述，Claude 会根据你当前的任务自动选择相关的笔记本。

---

为什么选择 NotebookLM 而非本地 RAG？

方法	Token 成本	设置时间	幻觉率	答案质量
将文档喂给 Claude	🔴 极高 (多次读取文件)	即时	有 - 填补空白	检索不稳定
网页搜索	🟡 中等	即时	高 - 来源不可靠	好坏参半
本地 RAG	🟡 中高	小时级 (向量化、分块)	中 - 检索存在盲区	取决于配置
NotebookLM MCP	🟢 极低	5 分钟	零 - 未知内容会拒绝回答	专家级综合

为什么 NotebookLM 表现更优？

1. 由 Gemini 预处理：文档上传一次，即可获得即时的专家级知识。
2. 自然语言问答：不仅仅是检索，而是真正的理解与综合。
3. 多源关联：能够关联跨越 50 多份文档的信息。
4. 基于引用：每个答案都包含来源引用。
5. 无需基础设施：无需向量数据库、嵌入（Embeddings）或复杂的分块策略。

---

安装

Claude Code

claude mcp add notebooklm npx notebooklm-mcp@latest

Codex

codex mcp add notebooklm -- npx notebooklm-mcp@latest

Gemini

gemini mcp add notebooklm npx notebooklm-mcp@latest

Cursor

添加到 ~/.cursor/mcp.json:

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

amp

amp mcp add notebooklm -- npx notebooklm-mcp@latest

VS Code

code --add-mcp '{"name":"notebooklm","command":"npx","args":["notebooklm-mcp@latest"]}'

其他 MCP 客户端

通用 MCP 配置：

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

---

替代方案：Claude Code Skill

比起 MCP，更喜欢 Claude Code Skills？ 本服务器现已作为原生的 Claude Code Skill 提供，设置更为简单：

NotebookLM Claude Code Skill - 克隆到 ~/.claude/skills 即可立即开始使用。

关键区别：

• MCP Server (本仓库)：支持持久会话，适用于 Claude Code、Codex、Cursor 及其他所有 MCP 客户端。
• Claude Code Skill：设置简单，基于 Python，无状态查询，仅适用于本地 Claude Code。

两者均使用相同的浏览器自动化技术，并提供基于你 NotebookLM 笔记本的零幻觉答案。

---

快速开始

1. 安装 MCP 服务器（参考上述安装部分）

2. 身份验证（仅需一次）

在你的对话框（Claude/Codex）中输入：

"Log me in"