jacob-bd/gemini-notebook-mcp-cli

Programmatic access to Gemini Notebook - via command-line interface (CLI), Model Context Protocol (MCP) server, and AI agent skills.

gemini‑notebook‑mcp‑cli

是什么 – 一个 Python 包，包含命令行工具（nlm）和 Model-Context-Protocol（MCP）服务器（notebooklm-mcp）。它允许你以编程方式控制 Google Gemini Notebook（前身为 Google NotebookLM），并将相同功能暴露给 AI 代理（如 Claude、Cursor 或 Gemini‑CLI）。

为何重要 – Gemini Notebook 是 Google 的个人知识库服务，可存储笔记本、源文件、音频/视频“工作室”制品以及交互式报告。通过提供稳定的 CLI 和 MCP 端点，该项目使笔记本可通过脚本、CI 流水线或其他使用 MCP 协议的 AI 助手访问。

快速入门（3 条命令）

安装 – uv tool install notebooklm-mcp-cli（或 pip install notebooklm-mcp-cli）。
登录 – nlm login（打开浏览器，提取 Google Cookie 并存储，可选地加密保存到操作系统密钥链中）。
连接工具 – nlm setup 运行交互式向导，发现本地 AI 工具（Claude、Cursor、Gemini‑CLI、Copilot 等），并将其注册到这些工具中。

核心功能

功能	CLI 命令	MCP 操作（对代理公开）
列出笔记本	`nlm notebook list`	`notebook_list`
创建笔记本	`nlm notebook create "My Project"`	`notebook_create`
添加源（URL、文本、Drive 文件）	`nlm source add <nb> --url …`	`source_add`
查询笔记本（添加到网页 UI）	`nlm notebook query "…"`	`notebook_query`
管理聊天会话	`nlm chats list/get/export`	`chat_list`, `chat_get`, `chat_export`
生成工作室内容（音频、视频、幻灯片）	`nlm studio create …`	`studio_create`
下载制品	`nlm download <type> …`	`download_artifact`
批处理/流水线工作流	`nlm batch …`, `nlm pipeline run`	`batch`, `pipeline`
标签与智能选择	`nlm tag add/list/select`	`tag`
使用情况/配额信息	`nlm usage`	`usage_get`
凭据保护	`nlm auth storage set protected`	–

代理如何使用它

运行 MCP 服务器 – notebooklm-mcp 启动本地 HTTP 端点。
代理注册 – 向导（nlm setup add <tool>）将 JSON 配置写入目标 AI 工具（Claude 桌面版、Cursor 等）。
自然语言调用 – 注册后，你可以向代理提问：“创建一个关于量子计算的笔记本并生成一个播客。” 代理将请求翻译为 MCP 调用（notebook_create, studio_create 等），服务器代表你与 Gemini Notebook 通信。

安装选项

方法	命令
uv（推荐）	`uv tool install notebooklm-mcp-cli`
uvx（无需安装运行）	`uvx --from notebooklm-mcp-cli nlm --help`
pip	`pip install notebooklm-mcp-cli`
pipx	`pipx install notebooklm-mcp-cli`
从源码	克隆仓库并运行 `uv tool install .`

nlm（CLI）和 notebooklm-mcp（MCP 服务器）都将出现在你的 $PATH 中。

认证与安全

使用从浏览器会话中提取的 Google Cookie（自动模式或手动文件导入）。
可选 受保护存储 将保存的 Cookie 使用 OS 密钥链加密；也支持纯文件存储，适用于无头或 Docker 环境。
支持多个配置文件（--profile work, --profile personal）。
提供无头刷新命令（nlm auth refresh）用于 cron 定时令牌更新。
免责声明 – 该工具连接未公开的内部 Google API；用途为个人/实验性，可能违反 Google 服务条款。

维护与升级

使用相同安装器升级（uv tool upgrade notebooklm-mcp-cli、pip install --upgrade … 等）。
旧包（notebooklm-cli, notebooklm-mcp-server）已弃用；README 包含迁移指南。
所有配置和缓存数据均位于 ~/.notebooklm-mcp-cli；任何更改前会自动备份。

许可与社区

许可证：MIT（参见 LICENSE）。
发布于 PyPI（徽章显示当前版本和下载统计）。
作者鼓励通过 Buy-Me-A-Coffee 捐赠以支持持续测试。

总结

gemini-notebook-mcp-cli 是一个实用的桥梁，将 Google 的 Gemini Notebook 转化为可编程服务，并使其可被不断增长的 AI 助手生态系统访问。如果你已使用 Claude、Cursor、Gemini‑CLI 或类似代理，并希望它们能读写笔记本、生成音视频或自动共享制品，这个包为你提供了开箱即用的 CLI + MCP 服务器，配置极简。