NotebookLM MCP 服务器

NotebookLM MCP服务器

让您的CLI代理（Claude、Cursor、Codex……）直接与NotebookLM聊天，根据您自己的笔记本获得零幻觉答案

安装 • 快速开始 • 为什么选择NotebookLM • 例子 • 克劳德代码技能 • 文档

问题

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

• 大量代币消费：在文档中搜索意味着重复读取多个文件
• 检索不准确：搜索关键字，忽略上下文和文档之间的连接
• 幻觉：当它找不到东西时，它会发明听起来合理的API
• 昂贵且缓慢：每个问题都需要重新阅读多个文件

解决方案

让您的本地代理商直接与 笔记本LM --谷歌的 零幻觉知识库 由Gemini 2.5提供支持，可从您的文档中提供智能、综合的答案。

Your Task → Local Agent asks NotebookLM → Gemini synthesizes answer → Agent writes correct code

真正的优势：NotebookLM和编辑器之间不再需要手动复制粘贴。您的代理直接询问NotebookLM，并在CLI中直接得到答案。它通过自动跟进建立了深入的理解——Claude按顺序提出了多个问题，每个问题都建立在最后一个问题的基础上，获得了具体的实现细节、边缘案例和最佳实践。您可以将NotebookLM链接保存到带有标签和描述的本地库，Claude会根据您当前的任务自动选择相关的笔记本。

为什么是NotebookLM，而不是本地RAG？

是什么让NotebookLM更出色？

1. 由Gemini预处理：上传文档一次，获得即时专家知识
2. 自然语言问答：不仅仅是检索----实际的理解和综合
3. 多源相关性：连接50多个文档中的信息
4. 引用支持：每个答案都包括源引用
5. 无基础设施：不需要矢量数据库、嵌入或分块策略

安装

克劳德代码

claude mcp add notebooklm npx notebooklm-mcp@latest

法典

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

gemini mcp add notebooklm npx notebooklm-mcp@latest

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

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

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

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

备选方案：Claude代码技能

更喜欢Claude代码技能而不是MCP？ 此服务器现在也可以作为本机Claude Code Skill使用，设置更简单：

NotebookLM克劳德代码技能 -克隆到 ~/.claude/skills 并立即开始使用

主要区别：

• MCP服务器 （此仓库）：持久会话，适用于Claude Code、Codex、Cursor和其他MCP客户端
• 克劳德代码技能：设置更简单，基于Python，无状态查询，仅适用于本地Claude代码

两者都使用相同的浏览器自动化技术，并从NotebookLM笔记本电脑提供零幻觉答案。

快速开始

1.安装MCP服务器（请参阅 安装 以上）

2.身份验证（一次性）

在聊天中说（Claude/Codex）：

"Log me in to NotebookLM"

Chrome窗口打开→ 用谷歌登录

3.创建您的知识库

首选 notebookm.google.com → 创建笔记本→ 上传您的文档：

• 📄 PDF、谷歌文档、markdown文件
• 🔗 网站，GitHub仓库
• 🎥 Youtube视频
• 📚 每个笔记本电脑有多个来源

分享： ⚙️ 分享→ 任何有链接的人→ Copy

4.让克劳德用吧

"I'm building with [library]. Here's my NotebookLM: [link]"

就这样 Claude现在向NotebookLM询问它需要什么，在编写代码之前建立专业知识。

真实世界示例

构建一个没有幻觉的n8n工作流

挑战：n8n的API是新的-Claude对节点名称和函数产生幻觉。

解决方案:

1. 已下载完整的n8n文档→ 合并成可管理的块
2. 上传到NotebookLM
3. 告诉克劳德： “为我构建一个Gmail垃圾邮件过滤器工作流。使用此NotebookLM:[链接]”

观看AI对AI对话：

Claude → "How does Gmail integration work in n8n?"
NotebookLM → "Use Gmail Trigger with polling, or Gmail node with Get Many..."

Claude → "How to decode base64 email body?"
NotebookLM → "Body is base64url encoded in payload.parts, use Function node..."

Claude → "How to parse OpenAI response as JSON?"
NotebookLM → "Set responseFormat to json, use {{ $json.spam }} in IF node..."

Claude → "What about error handling if the API fails?"
NotebookLM → "Use Error Trigger node with Continue On Fail enabled..."

Claude → ✅ "Here's your complete workflow JSON..."

结果：第一次尝试的完美工作流程。没有调试产生幻觉的API。

核心功能

零幻觉

如果您的文档中没有信息，NotebookLM拒绝回答。没有发明API。

自主研究

Claude会自动提出后续问题，在编码之前建立完整的理解。

智能图书馆管理

保存带有标签和描述的NotebookLM链接。Claude会自动为您的任务选择合适的笔记本。

"Add [link] to library tagged 'frontend, react, components'"

深入的迭代研究

• Claude会自动提出后续问题，以建立完整的理解
• 每个答案都会引发更深层次的问题，直到克劳德掌握了所有细节
• 示例：对于n8n工作流，Claude连续问了多个关于Gmail集成、错误处理和数据转换的问题

跨工具共享

设置一次，随处使用。Claude Code、Codex、Cursor——都共享同一个库。

深度清理工具

随时都可以重新开始。使用分类预览扫描整个系统以查找NotebookLM数据。

工具配置文件

通过仅加载所需的工具来减少令牌使用。每个工具都消耗上下文令牌——更少的工具=更快的响应和更低的成本。

可用配置文件

通过CLI配置

# Check current settings
npx notebooklm-mcp config get

# Set a profile
npx notebooklm-mcp config set profile minimal
npx notebooklm-mcp config set profile standard
npx notebooklm-mcp config set profile full

# Disable specific tools (comma-separated)
npx notebooklm-mcp config set disabled-tools "cleanup_data,re_auth"

# Reset to defaults
npx notebooklm-mcp config reset

通过环境变量进行配置

# Set profile
export NOTEBOOKLM_PROFILE=minimal

# Disable specific tools
export NOTEBOOKLM_DISABLED_TOOLS="cleanup_data,re_auth,remove_notebook"

设置已保存到 ~/.config/notebooklm-mcp/settings.json 并在会话中持续存在。环境变量会覆盖文件设置。

建筑

graph LR
    A[Your Task] --> B[Claude/Codex]
    B --> C[MCP Server]
    C --> D[Chrome Automation]
    D --> E[NotebookLM]
    E --> F[Gemini 2.5]
    F --> G[Your Docs]
    G --> F
    F --> E
    E --> D
    D --> C
    C --> B
    B --> H[Accurate Code]

常用命令

与备选方案的比较

vs.在本地下载文档

• 你：下载文档→ 克劳德：“搜索这些文件”
• 问题：克劳德读取了数千个文件→ 大量使用令牌，经常错过连接
• 笔记本LM：由Gemini预先索引，所有文档的语义理解

与网络搜索

• 你：“在线研究X”
• 问题：过时的信息、幻觉般的例子、不可靠的来源
• 笔记本LM：只有您信任的文档，始终是最新的，有引用

与本地RAG设置相比

• 你：设置嵌入、向量数据库、分块策略、检索管道
• 问题：经过数小时的设置、调整检索，仍然可以“创造性地”填补空白
• 笔记本LM：上传文档→ done.谷歌处理一切。

常见问题解答

真的是零幻觉吗？ 对。NotebookLM是专门为只从上传的源中回答问题而设计的。如果它不知道，它会这么说。

那么利率限制呢？ 免费版对每个Google帐户都有每日查询限制。支持快速切换帐户以继续研究。

这有多安全？ Chrome在本地运行。您的凭据永远不会离开您的计算机。如果担心，请使用专用的谷歌帐户。

我能看看发生了什么事吗？ 对！说 “显示浏览器” 观看NotebookLM的实时对话。

是什么让这比克劳德的内在知识更好？ 您的文档始终是最新的。没有训练中断。没有幻觉。非常适合新库、内部API或快速发展的项目。

高级用法

• 📖 使用指南 --模式、工作流程、技巧
• 🛠️ 工具参考 -完成MCP API
• 🔧 配置 --环境变量
• 🐛 故障排除 --常见问题

底线

无笔记本LM MCP：编写代码→ 发现它错了→ 调试幻觉API→ 重复

使用NotebookLM MCP：克劳德先研究→ 写入正确的代码→ 船速更快

停止调试幻觉。开始发送准确的代码。

# Get started in 30 seconds
claude mcp add notebooklm npx notebooklm-mcp@latest

免责声明

此工具自动化了浏览器与NotebookLM的交互，使您的工作流程更加高效。然而，一些友好的提醒：

关于浏览器自动化： 虽然我内置了人性化功能（逼真的打字速度、自然延迟、鼠标移动），使自动化行为更加自然，但我不能保证谷歌不会检测或标记自动化使用。我建议使用专用的谷歌帐户进行自动化，而不是你的主帐户——把它想象成网络抓取：可能很好，但安全总比后悔好！

关于CLI工具和AI代理： 像Claude Code、Codex和类似的人工智能助手这样的CLI工具非常强大，但它们也会出错。请谨慎使用：

• 在提交或部署之前，始终检查更改
• 首先在安全环境中进行测试
• 对重要工作进行备份
• 记住：人工智能代理是助手，而不是绝对可靠的神谕

我为自己构建了这个工具，因为我厌倦了NotebookLM和我的编辑器之间的复制粘贴舞蹈。我分享它是希望它也能帮助其他人，但我对可能发生的任何问题、数据丢失或帐户问题不承担责任。请自行判断和使用。

也就是说，如果你遇到问题或有疑问，请随时在GitHub上打开问题。我很乐意帮助排除故障！

贡献

发现bug了吗？有一个功能想法吗？ 打开一个问题 或者提交PR！

许可证

麻省理工学院——在你的项目中自由使用。

基于对幻觉API的失望而构建，由谷歌的NotebookLM提供支持

⭐ GitHub上的明星 如果这能节省您的调试时间！