如何直接从终端连接 Claude 和 Cursor 与 Google NotebookLM

Google NotebookLM 服务(最近更名为 Gemini Notebook)能够轻松处理大量文档、长篇 PDF 和 YouTube 视频。它能生成带有来源引用的连贯回复,还能创建由两个虚拟主持人主持的有趣音频播客。
该服务一个令人沮丧的细节是,它仍然缺乏官方的公开 API。
如果你想从终端批量上传链接到笔记本、导出生成的内容,或者让你的 AI 助手在 Cursor 中搜索你的个人知识库,你就只能困在浏览器中点击操作。开发者 jacob-bd 解决了这个问题,发布了 gemini-notebook-mcp-cli。它提供了命令行界面和本地 MCP 服务器,用于连接到代码编辑器。
该工具的功能
该仓库结合了两种工具:用于 bash 脚本的经典 CLI 和 MCP(Model Context Protocol)服务器。
通过终端命令,你可以管理笔记本而无需打开浏览器标签页。可用的操作包括创建笔记、上传资源、查询数据库和导出内容:
最有趣的部分从设置 MCP 开始。该包可以自动注册到流行工具的配置文件中:Claude Code、Claude Desktop、Cursor、Codeium、Windsurf 和 Zed。
快速设置命令:
之后,你可以在助手聊天中用纯文本编写:「创建一个关于分布式事务的笔记本,把这个拉取请求添加进去,并生成一个简要总结。」助手将在后台调用必要的函数。
隐藏的工作室功能
除了常规的文本回复外,该工具还解锁了对 Gemini Notebook 内容生成器的访问。通过 CLI 和 MCP,你可以运行:
- 播客创建(两位演讲者对主题的深入讨论)。
- 视频概览生成,支持多种时长和视觉风格。
- 抽认卡和学习指南制作。
- 基于上传资源的信息图表和思维导图。
- 创建和编辑演示幻灯片。
一个不错的额外功能:通过控制台或代码编辑器发送的所有请求都会保存在 Google 网页界面的历史记录中。你可以在终端开始查询,晚上再用手机通过浏览器继续查看回复。
底层授权机制
由于没有官方 API,该项目通过 Google 的内部端点工作。你需要一个已认证会话的有效 cookies。
项目开发者自动化了这个过程。你运行命令:
该工具会打开一个独立的浏览器配置文件(支持 Chrome、Brave、Arc、Edge、Chromium 和 Firefox),你登录你的 Google 账户,脚本会拦截必要的令牌并将其本地保存。
该工具支持通过标志处理多个配置文件。CSRF 令牌会在请求失败时自动刷新,cookies 本身的有效期为两到四周。
坦诚的创作故事与社区支持
项目作者在 README 中坦率承认,他在 Python 方面没有深入经验,主要依靠 AI 辅助完成了第一个版本。
代码解决了眼前的需求,但远非理想。作者没有回避这一点,直接向社区寻求重构和代码审查的帮助。
开源发挥了应有的作用。数十位开发者加入了这个项目。他们添加了连接池、正确的错误处理、WSL2 支持、Google Drive 同步、批量操作,以及防止凭证泄露到日志中的安全审计。结果是一个可靠的工具,在 GitHub 上获得了近 6000 颗星。
注意事项
在将该工具集成到你的流水线之前,请记住几个限制。
首先,使用未文档化的 API 存在破坏的风险。Google 可以随时更改请求格式或响应结构,脚本将停止工作,直到发布补丁。
其次,免费账户每天有大约 50 次请求的限制。如果你想一次运行一百个文档的批处理脚本,你会遇到这个上限。
第三,服务器暴露了 43 个独立的 MCP 工具。这个数量的函数会明显填满 Claude Code 或 Cursor 中的上下文窗口。如果你现在不处理笔记本,最好在设置中暂时禁用该服务器,或配置只导出你需要的方法。
安装
安装该工具最简单的方式是通过包管理器:
如果你使用标准 Python,pip 或 regular uv 都可以:
也可以通过 npx 运行而不进行永久安装:
适用人群
该项目适合那些已经积极使用 Gemini Notebook 分析大量文本、技术文档或讲座,但厌倦了浏览器操作的人。这个工具非常适合自动化资料收集、创建摘要导出脚本,以及将 Google Drive 中的上下文直接集成到与 AI 助手的工作聊天中。
相关项目