NotebookLM CLI & MCP 服务器

🎉 2026 年 1 月 — 重大更新！ 本项目已完全重构，将 NotebookLM-MCP 和 NotebookLM-CLI 统一为一个强大的软件包。一次安装即可同时获得命令行界面（CLI, nlm）和 MCP 服务器（notebooklm-mcp）。请参阅 CLI 指南 和 MCP 指南 获取完整文档。

通过命令行界面（CLI）或模型上下文协议（MCP）服务器访问 Google NotebookLM 的编程接口。

注意： 已针对专业版/免费版账户进行测试。可能适用于 NotebookLM 企业版账户，但尚未测试。

📺 观看演示视频

最新演示

Codex 设置 + 电影级视频与幻灯片

MCP 演示

总体概述	Claude Desktop	Perplexity Desktop	MCP 超级助手

CLI 演示

CLI 概述	CLI、MCP 与技能	设置、诊断与 mcpb	信息图支持

两种使用方式

🖥️ 命令行界面（CLI）

在终端中直接使用 nlm 进行脚本编写、自动化操作或交互式使用：

nlm notebook list                              # 列出所有笔记本
nlm notebook create "Research Project"         # 创建笔记本
nlm source add <notebook> --url "https://..."  # 添加源
nlm audio create <notebook> --confirm          # 生成播客
nlm download audio <notebook> <artifact-id>    # 下载音频文件
nlm share public <notebook>                    # 启用公开链接

运行 nlm --ai 以获取全面的 AI 助手文档。

🤖 MCP 服务器（用于 AI 智能体）

将 AI 助手（Claude、Gemini、Cursor 等）连接到 NotebookLM：

# 自动设置 — 为每个工具选择正确的配置
nlm setup add claude-code
nlm setup add gemini
nlm setup add cursor
nlm setup add cline
nlm setup add antigravity

# 为任何其他工具生成 JSON 配置
nlm setup add json

然后使用自然语言指令："创建一个关于量子计算的笔记本并生成播客"

功能特性

📚 更多文档：

• CLI 指南 — 完整的命令参考
• MCP 指南 — 所有 35 个 MCP 工具及示例
• 身份验证 — 设置与故障排除
• API 参考 — 贡献者使用的内部 API 文档

重要免责声明

此 MCP 和 CLI 使用的是内部 API（应用程序编程接口），这些 API：

• 未公开文档且可能在无通知的情况下更改
• 需要从浏览器中提取 Cookie（我有工具可以完成此操作！）

请自行承担风险，仅用于个人/实验目的。

安装

🆕 Claude Desktop 用户： 下载扩展（.mcpb 文件）→ 双击 → 完成！一键安装，无需配置。

从 Python 包索引（PyPI）安装。此单个软件包包含 CLI 和 MCP 服务器：

使用 uv（推荐）

uv tool install notebooklm-mcp-cli

使用 uvx（运行而不安装）

uvx --from notebooklm-mcp-cli nlm --help
uvx --from notebooklm-mcp-cli notebooklm-mcp

使用 pip

pip install notebooklm-mcp-cli

使用 pipx

pipx install notebooklm-mcp-cli

安装后，您将拥有：

• nlm — 命令行界面
• notebooklm-mcp — 供 AI 助手使用的 MCP 服务器

# 克隆仓库
git clone https://github.com/jacob-bd/notebooklm-mcp-cli.git
cd notebooklm-mcp

# 使用 uv 安装
uv tool install .

升级

# 使用 uv
uv tool upgrade notebooklm-mcp-cli

# 使用 pip
pip install --upgrade notebooklm-mcp-cli

# 使用 pipx
pipx upgrade notebooklm-mcp-cli

升级后，重启您的 AI 工具以重新连接到更新的 MCP 服务器：

• Claude Code： 重启应用程序，或使用 /mcp 重新连接
• Cursor： 重启应用程序
• Gemini CLI： 重启 CLI 会话

从旧版本升级

如果您之前安装了独立的 CLI（命令行界面）和 MCP（模型上下文协议）包，您需要迁移到统一包。

步骤 1：检查已安装的内容

uv tool list | grep notebooklm

需要移除的旧版包：

步骤 2：卸载旧版包

# 移除旧的 CLI 包（如果已安装）
uv tool uninstall notebooklm-cli

# 移除旧的 MCP 包（如果已安装）
uv tool uninstall notebooklm-mcp-server

步骤 3：重新安装统一包

移除旧版包后，重新安装以修复符号链接 (symlinks)：

uv tool install --force notebooklm-mcp-cli

为什么使用 --force？ 当多个包提供相同的可执行文件时，uv 在卸载后可能会留下损坏的符号链接。--force 标志确保生成干净的符号链接。

步骤 4：验证安装

uv tool list | grep notebooklm

您应该只看到：

notebooklm-mcp-cli v0.2.0
- nlm
- notebooklm-mcp

步骤 5：重新认证

您现有的 Cookie 应该仍然有效，但如果遇到认证 (auth) 问题：

nlm login

注意： MCP 服务器配置（在 Claude Code、Cursor 等中）无需更改——可执行文件名 notebooklm-mcp 保持不变。

卸载

要完全移除 MCP：

# 使用 uv
uv tool uninstall notebooklm-mcp-cli

# 使用 pip
pip uninstall notebooklm-mcp-cli

# 使用 pipx
pipx uninstall notebooklm-mcp-cli

# 移除缓存的认证令牌和数据（可选）
rm -rf ~/.notebooklm-mcp-cli

同时从您的 AI 工具中移除：

nlm setup remove claude-code
nlm setup remove cursor
# ... 或任何配置的工具

认证

在使用 CLI 或 MCP 之前，您需要与 NotebookLM 进行认证：

CLI 认证（推荐）

# 自动模式：启动您的浏览器，登录后自动提取 Cookie
nlm login

# 检查是否已认证
nlm login --check

# 使用命名配置文件（用于多个 Google 账户）
nlm login --profile work
nlm login --profile personal

# 手动模式：从文件导入 Cookie
nlm login --manual --file cookies.txt

# 外部 CDP（Chrome 开发者工具协议）提供商（例如 OpenClaw 管理的浏览器）
nlm login --provider openclaw --cdp-url http://127.0.0.1:18800

配置文件管理：

nlm login --check                    # 显示当前认证状态
nlm login switch <profile>           # 切换默认配置文件
nlm login profile list               # 列出所有带有电子邮件地址的配置文件
nlm login profile delete <profile>   # 删除配置文件
nlm login profile rename <old> <new> # 重命名配置文件

每个配置文件都会获得独立的浏览器会话，因此您可以同时登录多个 Google 账户。

独立认证工具

如果您只需要 MCP 服务器（不需要 CLI）：

nlm login              # 自动模式（启动浏览器）
nlm login --manual     # 手动文件模式

工作原理： 自动模式启动专用浏览器配置文件（支持 Chrome、Arc、Brave、Edge、Chromium 等），您登录 Google，Cookie 会自动提取。您的登录状态将在未来的认证刷新中保持持久化。

偏好特定浏览器吗？ 使用 nlm config set auth.browser brave 设置（或 arc, edge, chromium 等）。如果未找到首选浏览器，则回退到自动检测。

有关详细说明和故障排除，请参阅 docs/AUTHENTICATION.md。

MCP 配置

⚠️ 上下文窗口 (Context Window) 警告： 此 MCP 提供 35 个工具。不使用 NotebookLM 时请禁用它以保留上下文。在 Claude Code 中：使用 @notebooklm-mcp 切换。

自动设置（推荐）

使用 nlm setup 自动为您的 AI 工具配置 MCP 服务器——无需手动编辑 JSON：

# 添加到任何支持的工具
nlm setup add claude-code
nlm setup add claude-desktop
nlm setup add gemini
nlm setup add cursor
nlm setup add windsurf

# 为任何其他工具生成 JSON 配置
nlm setup add json

# 检查哪些工具已配置
nlm setup list

# 诊断安装及认证问题
nlm doctor

安装 AI 技能（可选）

为您的 AI 助手安装 NotebookLM 专家指南，以帮助其有效使用这些工具。支持 Cline、Antigravity、OpenClaw、Codex、OpenCode、Claude Code 和 Gemini CLI。

# 安装技能文件
nlm skill install cline
nlm skill install openclaw
nlm skill install codex
nlm skill install antigravity

# 更新技能
nlm skill update

从工具中移除

nlm setup remove claude-code

使用 uvx（无需安装）

如果您不想安装包，可以使用 uvx 即时运行：

# 直接运行 CLI 命令
uvx --from notebooklm-mcp-cli nlm setup add cursor
uvx --from notebooklm-mcp-cli nlm login

对于使用 JSON 配置的工具，指向 uvx：

{
  "mcpServers": {
    "notebooklm-mcp": {
      "command": "uvx",
      "args": ["--from", "notebooklm-mcp-cli", "notebooklm-mcp"]
    }
  }
}

claude mcp add --scope user notebooklm-mcp notebooklm-mcp
gemini mcp add --scope user notebooklm-mcp notebooklm-mcp

{
  "mcpServers": {
    "notebooklm-mcp": {
      "command": "notebooklm-mcp"
    }
  }
}

{
  "mcpServers": {
    "notebooklm-mcp": {
      "command": "/full/path/to/notebooklm-mcp"
    }
  }
}

📚 完整配置详情： MCP 指南 —— 服务器选项、环境变量、HTTP 传输、多用户设置和上下文窗口管理。

您可以做什么

只需使用自然语言与您的 AI 工具（Claude Code、Cursor、Gemini CLI）聊天。以下是一些示例：

研究与发现

• “列出我所有的 NotebookLM 笔记本”
• “创建一个名为 'AI 战略研究’ 的新笔记本”
• “开始关于 '企业 AI 投资回报率指标’ 的网页研究，并显示它找到了哪些来源”
• “深入研究 '云市场趋势’ 并导入前 10 个来源”
• “在我的 Google Drive 中搜索关于 '产品路线图’ 的文档并创建笔记本”

添加内容

• “将此 URL 添加到我的笔记本：https://example.com/article"
• “将此关于 Kubernetes 的 YouTube 视频添加到笔记本”
• “将我的会议笔记作为文本源添加到此笔记本”
• “将此 Google Doc 导入我的研究笔记本”

AI 驱动的分析

• “这个笔记本中的关键发现是什么？”
• “总结所有这些来源的主要论点”
• “这个来源关于安全最佳实践说了什么？”
• “获取关于此笔记本内容的 AI 摘要”
• “配置聊天以使用学习指南风格并生成较长的回复”

(所有通过 CLI（命令行界面）或 MCP（模型上下文协议）发送的查询都会自动保存在您的 NotebookLM Web UI 聊天历史中！)

内容生成

• “以此笔记本为基础创建一个深度挖掘格式的音频播客概述”
• “生成一个具有经典视觉风格的视频解释器”
• “基于这些来源制作一份简报文档”
• “为学习制作中等难度的抽认卡”
• “生成一张具有专业风格的横向信息图”
• “根据我的研究来源构建思维导图”
• “从此笔记本创建一个幻灯片演示文稿”

智能管理

• “检查哪些 Google Drive 来源已过时并同步它们”
• “显示此笔记本中的所有来源及其新鲜度状态”
• “从此笔记本删除此来源”
• “检查我的音频概述生成的状态”

小贴士： 在创建工作室内容（音频、视频、报告等）后，轮询状态以在生成完成时获取下载链接。

身份验证生命周期

v0.1.9+：服务器现在自动处理令牌过期：

1. 当令牌过期时立即刷新 CSRF 令牌
2. 如果外部更新了 Cookie，则从磁盘重新加载
3. 如果配置文件已保存登录信息，则运行无头浏览器认证

您也可以调用 refresh_auth() 来显式重新加载令牌。

如果自动刷新失败（Google 登录完全过期），请再次运行 nlm login。

故障排除

uv tool upgrade 未安装最新版本

表现：

• 运行 uv tool upgrade notebooklm-mcp-cli 安装了旧版本（例如 0.1.5 而不是 0.1.9）
• uv cache clean 无法解决问题

原因： uv tool upgrade 尊重您原始安装时的版本约束。如果您最初安装了旧版本或带有约束的版本，upgrade 在设计上会保持在那些范围内。

修复 —— 强制重新安装：

uv tool install --force notebooklm-mcp-cli

这将绕过任何缓存约束并从 PyPI（Python 包索引）安装绝对最新版本。

验证：

uv tool list | grep notebooklm
# 应显示：notebooklm-mcp-cli v0.1.9（或最新版本）

限制

• 速率限制：免费版每天约 50 次查询
• 无官方支持：API 可能会在不另行通知的情况下更改
• Cookie 过期：需要每隔几周重新提取 Cookie

贡献

有关详细的 API 文档和如何添加新功能，请参阅 CLAUDE.md。

氛围编码提示

完全透明地说：这个项目是由一名非开发人员使用 AI 编程助手构建的。如果您是一位经验丰富的 Python 开发人员，看到这段代码库可能会皱眉。没关系。

这里的目标是解决一个痛点——对 NotebookLM 进行程序化访问——并在过程中学习。代码是可以工作的，但它可能缺少只有多年经验才能提供的模式、优化或优雅性。

这就是您需要参与的地方。 如果您看到让您皱眉的内容，请考虑贡献而不是仅仅关闭标签页。这之所以是开源的，正是因为人类专业知识是不可替代的。无论是重构、更好的错误处理、类型提示还是架构指导——欢迎提交 PR（拉取请求）和 Issues（问题）。

将其视为通过代码审查指导 AI 辅助开发者的机会。当经验丰富的开发人员分享他们的知识时，我们所有人都会受益。

致谢

特别感谢：

• Le Anh Tuan (@latuannetnam) 贡献了 HTTP（超文本传输协议）传输层、调试日志系统和性能优化。
• David Szabo-Pele (@davidszp) 贡献了 source_get_content 工具和 Linux 认证修复。
• saitrogen (@saitrogen) 贡献了研究轮询查询回退修复。
• devnull03 (@devnull03) 贡献了多浏览器 CDP（Chrome 开发工具协议）认证支持（Arc, Brave, Edge, Chromium, Vivaldi, Opera）。
• VooDisss (@VooDisss) 贡献了多浏览器认证改进。
• codepiano (@codepiano) 贡献了用于认证 CLI 的可配置 DevTools（开发者工具）超时。
• Tony Hansmann (@997unix) 贡献了 nlm setup 和 nlm doctor 命令以及 CLI 指南文档。
• Fabiana Furtado (@fabianafurtadoff) 贡献了批量操作、跨笔记本查询、管道和智能选择/标记（PR #90）。

星标历史

许可证

MIT 许可证

notebooklm-mcp-cli 快速上手指南

notebooklm-mcp-cli 是一个统一的工具包，提供通过命令行界面（CLI）或模型上下文协议（MCP）服务器对 Google NotebookLM 进行编程访问的功能。它允许您自动化创建笔记本、添加来源、生成播客并与 AI 助手集成。

环境准备

• 操作系统: Linux, macOS, Windows
• Python 版本: 支持 Python 3.8+
• 依赖工具: 推荐安装 uv 或 pip
• 网络要求: 需能访问 Google 服务（用于认证和数据同步）
• 浏览器: 用于提取登录 Cookie（Chrome, Edge, Brave, Arc 等）

安装步骤

推荐使用 uv 进行安装，速度更快且管理更方便。

方式一：使用 uv（推荐）

uv tool install notebooklm-mcp-cli

方式二：使用 pip（国内加速）

如果您偏好使用 pip，建议配置国内镜像源以加快下载速度：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple notebooklm-mcp-cli

方式三：使用 pipx（隔离环境）

pipx install notebooklm-mcp-cli

安装完成后，您将拥有两个主要命令：

• nlm: 命令行接口
• notebooklm-mcp: MCP 服务器

基本使用

1. 身份认证

在使用任何功能前，必须先登录您的 Google NotebookLM 账号。

# 自动模式：打开浏览器登录并自动提取 Cookie
nlm login

# 检查当前登录状态
nlm login --check

# 多账号支持：创建不同配置文件
nlm login --profile work
nlm login --profile personal

2. 命令行操作 (CLI)

直接使用 nlm 命令在终端中管理 NotebookLM。

# 列出所有笔记本
nlm notebook list

# 创建新笔记本
nlm notebook create "Research Project"

# 添加来源（URL、文本等）
nlm source add <notebook> --url "https://..."

# 生成音频播客
nlm audio create <notebook> --confirm

# 查询笔记本内容
nlm notebook query <notebook>

运行 nlm --ai 可获取 AI 辅助的完整文档说明。

3. 集成 AI 助手 (MCP)

将 NotebookLM 连接到 Claude、Cursor、Gemini 等 AI 工具。

# 自动配置特定工具（无需手动编辑 JSON）
nlm setup add claude-code
nlm setup add cursor
nlm setup add gemini

# 查看已配置的工具
nlm setup list

配置完成后，您可以在 AI 助手中直接输入自然语言指令，例如：“创建一个关于量子计算的笔记本并生成播客”。

⚠️ 注意事项 本工具使用 NotebookLM 的内部 API，这些 API 未公开文档化且可能随时变更。请仅用于个人实验目的，使用时风险自担。