用途:本技能供 AI Agent 阅读并据以指导使用者完成 NotebookLM MCP 的安装与授权连接,使 Agent 之后可透过 MCP 存取使用者的 NotebookLM 帳号内容。
主要流程与能力:
- 前置检查:以 uv --version 确认已安装 uv,未安装则先请使用者安装。
- 安装 CLI:执行 uv tool install notebooklm-mcp-cli,并以 nlm --version 验证,应显示类似 nlm version 0.5.19。此步骤会安装 nlm(命令列工具)与 notebooklm-mcp(MCP 伺服器本体)。
- 登入:执行 nlm login,由使用者本人在浏览器完成 Google OAuth 授权;Agent 不得代填或索取授权码。多帳号可用 nlm login switch <profile> 切换,切换后 MCP 伺服器立即改用新默认 profile,不需重启。
- 验证登录:执行 nlm doctor 查看 Authentication 区块,确认 Account 为正确信箱;再以 nlm list 确认可列出筆記本。
- 注册 MCP:使用 nlm setup add antigravity,成功会写入 C:\Users<你>.gemini\antigravity\mcp_config.json 并提示重启 AntiGravity。文档警告不要执行 nlm setup list,因其在 Windows 繁体中文(cp950)环境会崩溃,检查状态请改用 nlm doctor。文件也提供手动设定备援:mcp_config.json 中 mcpServers 下加入 notebooklm,command 为字符串 "notebooklm-mcp",args 为空阵列;并列出常见错误写法(command 写成阵列、加上 type 或 enabled 字段、缺少 mcpServers 外层)。若桌面版找不到执行档,可改用绝对路径并加上 --transport stdio。另说明桌面版读 ~/.gemini/antigravity/mcp_config.json,CLI(agy)读 ~/.gemini/config/mcp_config.json,两者分开,CLI 需另外加入。
- 重启并确认:重启 AntiGravity 后实际呼叫工具,例如列出筆記本清单,能列出即完成。
- 选用:可执行 nlm skill install antigravity 安装操作技能说明,并以 nlm skill list 确认。
疑难排解涵盖:nlm setup list 崩溃、Windows 编码错误(可设 $env:PYTHONIOENCODING = "utf-8",但对 setup list 无效)、认证失效重跑 nlm login、nlm 指令找不到时检查 local bin 是否在 PATH、MCP 未出现时的检查顺序、无浏览器环境须先在有浏览器的机器完成登录、以及以 nlm setup remove antigravity 移除设定。
安全守则:不要复制或转贴 cookie、token、授权码;不要把筆記本清单或来源内容 commit 进 repo;不要向使用者索取 Google 密码;授权一律走 nlm login 的浏览器 OAuth。
完成后 Agent 可执行的操作包括:列出/建立/删除筆記本、新增来源(網址、文字、Google Drive 檔案、本機檔案)、对筆記本提问与跨筆記本查询、产生 Studio 产物(音讯总览、影片、资讯图表、简报)并下载、管理筆記与分享设定。
限制:文档中的验证环境为 notebooklm-mcp-cli 0.5.19 与 Windows 11;OAuth 需要浏览器;nlm setup list 在特定环境有已知崩溃问题。其余平台与版本相容性暂未提供。