gemini-notebook-mcp-cli

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 971 🐛 待处理 3 👀 关注 42

GitHub ↗

GitHub 星标 ★ 6468

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务

项目预览

gemini-notebook-mcp-cli 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队jacob-bd

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

GitHub 星标★ 6468

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

代码更新2026-11-05

仓库体积5.2 MB

本站数据更新2026-11-06

维护状态活跃

收录时间2026-09-22

浏览次数1

项目介绍

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 助手知识操作能力或做批量内容处理的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 6468

使用教程

难度：入门约 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`