jacob-bd/gemini-notebook-mcp-cli

Gemini Notebook（前身为 Google NotebookLM）CLI 与 MCP 服务器

是什么 – 一个 Python 包，允许你通过命令行或 模型上下文协议（MCP）服务器 控制 Google 的 Gemini Notebook（该服务曾名为 Notebook LM）。MCP 服务器可连接到 AI 助手工具，如 Claude、Cursor、Gemini-CLI、GitHub Copilot 等，使这些智能体能够自动读取、写入并生成你的 Gemini Notebook 中的内容。

核心功能

领域	CLI 命令（示例）	MCP 工具名称
列出笔记本	nlm notebook list	notebook_list
创建笔记本	nlm notebook create "Research Project"	notebook_create
添加来源（URL、文本、Drive 文件、上传）	nlm source add <nb> --url "https://…"	source_add
查询笔记本（在网页 UI 中添加聊天条目）	nlm notebook query "Summarize key points"	notebook_query
管理聊天会话	nlm chats list / nlm chats get <id>	chat_list, chat_get
生成 Studio 内容（音频、视频、幻灯片、信息图等）	nlm studio create <nb> audio	studio_create
修订幻灯片演示文稿	nlm slides revise <nb>	studio_revise
下载成果物	nlm download audio <nb> <artifact-id>	download_artifact
批量下载所有成果物	nlm download all <nb> -d ./exports	download_all_artifacts
同步 Drive 来源	nlm source sync	source_sync_drive
批量操作、跨笔记本查询、流水线、标签等功能	nlm batch …, nlm cross query …, nlm pipeline run …, nlm tag add …	batch, cross_notebook_query, pipeline, tag
分享笔记本（公开链接或邀请）	nlm share public <nb>	notebook_share_*
配置 AI 工具（Claude、Cursor、Gemini-CLI 等）	nlm setup add claude-code	–
安装“技能”以教会助手使用 MCP	nlm skill install cline	–
诊断问题	nlm doctor	–

如何使用

1. 安装 – pip install notebooklm-mcp-cli（或推荐的 uv tool install notebooklm-mcp-cli）。
2. 认证 – nlm login 会打开浏览器，提取 Google Cookie 并本地存储。支持多配置文件，可管理多个 Google 账号。
3. 运行 CLI – nlm … 可用于脚本化创建笔记本、添加来源、生成内容、下载、分享等操作。
4. 暴露 MCP 服务器 – notebooklm-mcp 启动本地 HTTP 服务，供 AI 助手调用。通过 nlm setup add <tool>，该包会为 Claude Desktop、Cursor、GitHub Copilot 等工具生成相应的 JSON 配置，使这些智能体可调用内置的 43 个 MCP 工具。
5. 与你的助手对话 – MCP 注册完成后，你只需说类似 “创建一个关于量子计算的笔记本并生成一个播客”，助手就会在后台调用相应的 MCP 端点。

安装与升级

• 推荐方式：uv tool install notebooklm-mcp-cli（或使用 uvx 一次性运行）。
• 也支持通过 pip / pipx 安装。
• 升级使用相同命令（uv tool upgrade … 或 pip install --upgrade …）。
• 安装统一包前，必须移除旧版包（notebooklm-cli、notebooklm-mcp-server）。

安全提示 – 该工具调用的是 未公开的 Google 内部 API，需要从浏览器导出 Cookie。这些 API 可能随时变更，因此本包仅适用于个人/实验用途。

适用人群 – 开发者、研究人员或高级用户，希望以程序化或 AI 智能体驱动的方式访问 Gemini Notebook，用于自动化研究聚合、内容生成（音频、视频、幻灯片、信息图）、批量导出或无需手动操作网页 UI 即可分享笔记本等任务。

---

一个快速上手示例

# 安装
uv tool install notebooklm-mcp-cli

# 登录（打开浏览器，提取 Cookie）
nlm login

# 创建笔记本并添加来源
nlm notebook create "AI Strategy"
nlm source add "AI Strategy" --url "https://arxiv.org/abs/2302.12345"

# 要求笔记本总结内容
nlm notebook query "Summarize the main findings"

# 生成播客并下载
nlm studio create "AI Strategy" audio
nlm download all "AI Strategy" -d ./exports

MCP 注册示例（适用于 Claude Desktop）

nlm setup add claude-code   # 将所需 JSON 写入 Claude 的配置

现在 Claude 可以运行命令如 @gemini-notebook-mcp notebook_create "My Notebook"。

---

资源

• 完整文档：docs/GETTING_STARTED.md、docs/CLI_GUIDE.md、docs/MCP_GUIDE.md
• README 中链接的演示视频展示了 CLI 使用方式以及与各类助手的 MCP 集成。
• 该包已发布在 PyPI 上，包名为 notebooklm-mcp-cli。