gemini-notebook-mcp-cli

让 AI 智能体和脚本直接读写 Gemini Notebook

gemini-notebook-mcp-cli 是一个让程序化访问 Gemini Notebook 的开源工具，提供命令行界面（CLI）、Model Context Protocol（MCP）服务器以及 AI 智能体技能三种接入方式。它解决的核心问题是：Gemini Notebook 本身主要面向人工交互，难以被脚本、自动化流程或 AI 智能体直接调用。该项目把笔记本的读取、查询、内容操作等能力封装成可编程接口，使开发者能在终端里直接操作，也能让 Claude、Cursor 等支持 MCP 的客户端把 Notebook 当作工具来调用，还能作为 agent skill 嵌入智能体工作流。核心能力包括：统一的 CLI 命令集、符合 MCP 规范的服务器实现、面向智能体的技能封装，以及 Python 生态下的可扩展集成。适合需要把 Gemini Notebook 纳入自动化管线、构建 AI 助手知识操作能力或做批量内容处理的开发者。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6125

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队jacob-bd

所属国家

官网地址

GitHubhttps://github.com/jacob-bd/gemini-notebook-mcp-cli

定价模式free

价格说明开源免费，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型

GitHub 星标★ 6125

30天Star增速

HF 下载量

上线时间2025-12-23 00:00:00

最近更新2026-09-21 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

已安装 uv（含 uvx），用于安装与运行 PyPI 包 notebooklm-mcp-cli
可用的 Gemini Notebook（原 Google NotebookLM）账号，消费级个人账号测试较充分，Enterprise 为实验性支持
可选：支持 MCP 的客户端（Claude Code、Claude Desktop、Cursor、Cline、Gemini CLI 等）
Windows/macOS/Linux 均可，Claude Desktop 配置路径因系统而异

安装与启动步骤

1免安装试用 CLI

用 uvx 直接从 PyPI 拉取运行，不写入本地环境，先确认命令可用。
```
uvx --from notebooklm-mcp-cli nlm --help
```
2安装统一包

安装同时包含 CLI 与 MCP 服务器的单一包；加 --force 可避免卸载旧包后残留失效软链接。
```
uv tool install --force notebooklm-mcp-cli
```
3验证安装结果

应只看到一个包及 nlm、notebooklm-mcp 两个可执行入口。
```
uv tool list | grep notebooklm
```
4登录账号

首次使用需登录 Gemini Notebook，按提示完成浏览器授权。
```
nlm login
```
5自动配置 MCP 客户端

按所用工具选择子命令，自动写入对应配置文件，无需手改 JSON。
```
nlm setup add claude-code
nlm setup add claude-desktop
nlm setup add cursor
nlm setup add gemini
```
6安装 AI 技能

可选步骤，为智能体安装 Gemini Notebook 使用指南，帮助其正确调用工具。
```
nlm skill install cline
nlm skill install codex
```
7诊断问题

安装或鉴权异常时运行，排查配置与登录状态。
```
nlm doctor
```

关键配置

配置项	必填	说明	示例
`mcpServers.gemini-notebook-mcp.command`	是	本地安装后 MCP 客户端启动服务器的命令名	`notebooklm-mcp`
`mcpServers.gemini-notebook-mcp.args`	否	用 uvx 免安装方式时传入包名与入口，本地安装可留空数组	`["--from", "notebooklm-mcp-cli", "notebooklm-mcp"]`
`servers`	是	GitHub Copilot 在 .vscode/mcp.json 中使用顶层 servers 键而非 mcpServers	`servers`
`--profile`	否	Claude Desktop 存在多配置文件时选择 regular、3p 或 both	`regular`
`command（绝对路径）`	否	Claude Desktop 可能不解析 PATH，需填二进制完整路径	`/full/path/to/notebooklm-mcp`

如何确认成功

执行 uv tool list | grep notebooklm，应只显示 notebooklm-mcp-cli v0.2.0 及 nlm、notebooklm-mcp 两个入口。

常见问题

Q：为什么重装时要加 --force？

A：多个包提供同名可执行文件时，uv 卸载后可能残留失效软链接，--force 可确保重新生成正确的软链接。

Q：uv tool upgrade 装不到最新版怎么办？

A：uv tool upgrade 会沿用最初安装时的版本约束，缓存清理无效，建议卸载后重新安装以获取最新版本。

Q：Claude Desktop 配置写不进去？

A：写入前需完全退出对应 Claude Desktop 实例，CLI 检测到程序运行中会拒绝写入，配置完成后再重新打开。

Q：配置里填 notebooklm-mcp 报找不到命令？

A：部分客户端不解析 PATH，先运行 which notebooklm-mcp 取完整路径，再填到配置的 command 字段。

注意事项

该 MCP 提供 43 个工具，不使用时请禁用，以免占用模型上下文窗口。
Claude Desktop 用户可在 Releases 页下载 .mcpb 扩展，双击即可一键安装，无需手工配置。
从旧版 notebooklm-cli 或 notebooklm-mcp-server 迁移时，需先 uv tool uninstall 旧包再重装统一包。
Gemini Notebook Enterprise 支持仍属实验性，部分企业主机变体可能需要额外验证。

核心亮点

同时提供 CLI、MCP 服务器和 agent skills 三种接入方式，覆盖终端、AI 客户端和智能体三类使用场景
基于 MCP 标准协议，可被 Claude Desktop、Cursor 等主流 MCP 客户端直接挂载为工具
用 Python 实现，便于二次开发和与现有 Python 自动化脚本集成

不足之处

依赖 Gemini Notebook 的接口或登录态，上游变动可能导致功能失效
文档和社区生态相对早期，遇到问题可参考的案例有限

适用场景

在终端中用命令行批量查询、整理 Gemini Notebook 内容
把 Gemini Notebook 挂载到 Claude 等 MCP 客户端，让 AI 直接读取笔记作为上下文
在自建 AI 智能体工作流中调用 notebook 技能，实现自动记录和检索

替代项目

notebooklm-mcp、mcp-server-fetch

项目介绍

gemini-notebook-mcp-cli 是智能体领域的开源项目，由 jacob-bd 开发，2025 年首次发布。

在全站 12,909 个收录项目中，它的 GitHub 星标数（6,125）位列前 8%，在智能体分类的 2,491 个项目里位列前 8%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-21。开源免费，无在线服务。

它主要面向的使用场景是：在终端中用命令行批量查询、整理GeminiNotebook内容。同类可对比的替代方案包括 notebooklm-mcp、mcp-server-fetch。

上一篇：agentcore-samples

下一篇：Paper2Agent