一個套件, CLI 與 MCP 兼得。
Google NotebookLM 沒有公開 API。這個專案的做法,是直接呼叫 NotebookLM 的內部(未公開)API,讓你能在 NotebookLM 的網頁介面之外,用程式操作筆記本、來源與生成內容。作者於 2026 年 1 月把原本分開的 NotebookLM-MCP 與 NotebookLM-CLI 重構合併成單一套件:一次安裝,同時得到 nlm(CLI)與 notebooklm-mcp(MCP 伺服器)。
兩種用法對應兩種場景。nlm 適合在終端機腳本化、自動化或互動操作;notebooklm-mcp 則透過 Model Context Protocol,把 Claude、Cursor、Gemini 等 AI 代理接上 NotebookLM,讓你用自然語言下指令——例如「建立一個關於量子運算的筆記本,並生成一段 podcast」。所有從 CLI 或 MCP 發出的查詢,都會同步寫回 NotebookLM 網頁介面的對話紀錄。
專案以 Python 撰寫,MIT 授權。作者自述已在 Pro / 免費方案與 Google AI Ultra(每月 249 美元)帳號上測試;Enterprise 帳號未經測試。因為依賴內部 API 與瀏覽器 cookie,它定位為個人 / 實驗用途,風險自負。
登入擷取 cookie
建立筆記本
加來源
AI 查詢
生成 Studio
下載 / 分享
Programmatic access to Google NotebookLM — via command-line interface (CLI) or MCP server.
一行 uv tool install, CLI 與伺服器一起到位。
環境需求:Python 3.8+、一個能存取 NotebookLM 的 Google 帳號,以及一個現代瀏覽器(Chrome、Arc、Brave、Edge、Chromium、Vivaldi、Opera 皆可,用於擷取登入 cookie)。從 PyPI 安裝這個套件即可,它同時包含 CLI 與 MCP 伺服器。官方建議用 uv。
# 建議:uv(裝完得到 nlm 與 notebooklm-mcp 兩個指令)
uv tool install notebooklm-mcp-cli
# 或:不安裝直接執行
uvx --from notebooklm-mcp-cli nlm --help
# 或:pip / pipx
pip install notebooklm-mcp-cli
pipx install notebooklm-mcp-cli登入:從瀏覽器擷取 cookie
使用前需先驗證。nlm login 會啟動瀏覽器讓你登入 Google,並自動擷取 cookie。多個 Google 帳號可用具名 profile 分開管理,每個 profile 有獨立的瀏覽器 session。
nlm login # 自動模式:開瀏覽器、登入、擷取 cookie
nlm login --check # 檢查目前驗證狀態
nlm login --profile work # 為多帳號使用具名 profile
nlm login --manual --file cookies.txt # 手動匯入 cookie每個能力, 都有 CLI 指令與 MCP 工具。
功能在 CLI 與 MCP 兩邊一一對應:同一個能力,既有 nlm 指令,也有對應的 MCP 工具名稱(MCP 端共 35 個工具)。下面先看主要能力,再用一張表對照 CLI 指令與 MCP 工具。
筆記本 · 01
nlm notebook list / create
管理筆記本
列出、建立、管理筆記本。MCP 工具 notebook_list、notebook_create。
筆記本 · 02
nlm notebook query
AI 查詢
對筆記本提問做 AI 分析,查詢會同步寫回 NotebookLM 網頁的對話紀錄。
來源 · 03
nlm source add
加來源
支援 URL、文字、Google Drive、檔案四種來源類型。MCP 工具 source_add。
來源 · 04
nlm source sync
同步 Drive
同步 Google Drive 來源、檢查來源新鮮度,並可擷取來源內容。
Studio · 05
nlm studio create
生成 Studio 內容
產出 podcast、影片、投影片、資訊圖、心智圖、字卡等。MCP 工具 studio_create。
Studio · 06
nlm slides revise
修訂投影片
對已生成的投影片做修訂調整。MCP 工具 studio_revise。
下載 · 07
nlm download <type>
下載產出檔
下載 audio 等 artifact。生成後輪詢狀態,完成時取得下載連結。
研究 · 08
nlm research start
Web / Drive 研究
啟動網路或 Drive 深度研究,找出來源並匯入筆記本。MCP 工具 research_start。
分享 · 09
nlm share public / invite
分享協作
開啟公開連結或邀請協作者(可設檢視 / 編輯權限)。
批次 · 10
nlm batch
批次操作
批次 query / create / delete,一次處理多個筆記本。MCP 工具 batch。
跨庫 · 11
nlm cross query
跨筆記本查詢
同一個問題跨多個筆記本查詢。MCP 工具 cross_notebook_query。
進階 · 12
nlm pipeline / nlm tag
流程與標籤
pipeline 串接多步驟工作流;tag 做標籤與智慧選擇。MCP 工具 pipeline、tag。
CLI 指令 ↔ MCP 工具對照
| 能力 | CLI 指令 | MCP 工具 |
|---|---|---|
| 列出筆記本 | nlm notebook list | notebook_list |
| 建立筆記本 | nlm notebook create | notebook_create |
| 加來源(URL / 文字 / Drive / 檔案) | nlm source add | source_add |
| 查詢筆記本(寫回網頁 UI) | nlm notebook query | notebook_query |
| 生成 Studio 內容 | nlm studio create | studio_create |
| Web / Drive 研究 | nlm research start | research_start |
| 跨筆記本查詢 | nlm cross query | cross_notebook_query |
| 診斷安裝 / 驗證問題 | nlm doctor | — |
接上 AI 代理, 幾個指令少踩雷。
以下要點整理自官方 README。重點是用 nlm setup 自動設定各家 AI 工具、用 nlm doctor 診斷問題,以及管理多帳號、瀏覽器與 context 用量。
SET 01 · 一鍵自動設定各家工具
nlm setup add <tool> 自動寫好設定,免手改 JSON。支援 claude-code、claude-desktop、gemini、github-copilot、cursor、windsurf、cline、antigravity,或 json 產生通用設定。
來源 · 官方 README · MCP Configuration
SET 02 · 裝完先跑 nlm doctor
遇到問題時,nlm doctor 會診斷安裝與驗證狀況;nlm setup list 列出已設定的工具。先看這兩個再排錯。
來源 · 官方 README
SET 03 · 裝 AI Skill 讓代理更會用
nlm skill install <tool> 為代理安裝 NotebookLM 使用指南,支援 Cline、Antigravity、OpenClaw、Codex、OpenCode、Claude Code、Gemini CLI。nlm skill update 更新。
來源 · 官方 README · Install AI Skills
SET 04 · 多帳號用 profile 分開
nlm login --profile work 為每個 Google 帳號建獨立 profile(各有獨立瀏覽器 session)。nlm login switch 切換、nlm login profile list 列出。
來源 · 官方 README · Authentication
SET 05 · 指定擷取 cookie 的瀏覽器
nlm config set auth.browser chromium(或 brave、arc、edge、chrome 等)指定偏好瀏覽器,找不到時退回自動偵測。多瀏覽器皆支援。
來源 · 官方 README · Authentication
SET 06 · 35 個工具會佔 context
官方提醒:此 MCP 提供 35 個工具,不用 NotebookLM 時建議停用以節省脈絡。在 Claude Code 用 @notebooklm-mcp 切換開關。
來源 · 官方 README · Context Window Warning
SET 07 · Claude Desktop 用 .mcpb 一鍵裝
到 release 頁下載 .mcpb 擴充檔,雙擊即完成,免設定。手動設定時 Claude Desktop 可能無法解析 PATH,需填 notebooklm-mcp 的完整路徑(用 which 查)。
來源 · 官方 README · Installation
SET 08 · 不想安裝就用 uvx
不安裝套件也能跑:uvx --from notebooklm-mcp-cli nlm login。JSON 設定也可把 command 指向 uvx,args 帶 --from notebooklm-mcp-cli notebooklm-mcp。
來源 · 官方 README · Using uvx
從登入到 podcast, 一條龍跑一次。
下面示範一段 CLI 流程:登入、建立筆記本、加來源、AI 查詢,最後生成 podcast 並下載。Studio 內容是非同步生成的,所以建立後要輪詢狀態,完成時才取得下載連結。流程最後也附上 MCP 端的自然語言用法。
$ nlm login
ok: ✓ 已登入 · cookie 擷取完成 · profile: default
$ nlm notebook create "AI Strategy Research"
claude: created notebook · id: nb_8f3a...
$ nlm source add nb_8f3a --url "https://example.com/report"
claude: source added · processing... ✓
$ nlm notebook query nb_8f3a "這份報告的關鍵發現是什麼?"
claude: → 三項關鍵發現:1) ... 2) ... 3) ...(附引用段落)
$ nlm audio create nb_8f3a --confirm
ok: ✓ 完成 · artifact-id: art_19c2
$ nlm download audio nb_8f3a art_19c2
ok: saved → ./AI-Strategy-Research-overview.mp3
$ › "建立一個關於量子運算的筆記本,並生成一段 podcast"
claude: [呼叫 notebook_create → source_add → studio_create]
ok: done · 筆記本已建立、podcast 生成中
所有從 CLI 或 MCP 發出的查詢, 都會自動同步到你的 NotebookLM 網頁對話紀錄。
這段流程的重點
CLI 與 MCP 操作的不是另一份資料,而是你真正的 NotebookLM 帳號:建立的筆記本、加入的來源、發出的查詢,在網頁介面都看得到。這讓自動化腳本與互動式使用可以無縫接續——用指令批次處理,再回網頁手動細修。
MCP 端的價值則是自然語言:一句「建立一個關於量子運算的筆記本,並生成一段 podcast」,代理會自行串起 notebook_create、source_add、studio_create 等工具。Studio 內容是非同步生成,記得輪詢狀態取得下載連結。
非官方工具, 知道邊界再用。
從單次操作, 到批次與多步驟流程。
跑通基本流程後,進階用法多半圍繞規模化與多帳號管理。下列路徑都對應 README 文件中的功能。
進階用法地圖
1. 裝 AI Skill。nlm skill install 為代理安裝 NotebookLM 使用指南,讓它知道何時該用哪個工具——尤其在 35 個工具裡更容易選對。
**2. 多帳號 profile。**每個 profile 有獨立的瀏覽器 session,可同時登入多個 Google 帳號;用 nlm login switch 切換目前帳號。
3. 用 pipeline 串多步驟。nlm pipeline run / list 把「研究 → 匯入來源 → 查詢 → 生成」等步驟組成可重複執行的工作流。
4. 批次與跨庫查詢。nlm batch 一次對多個筆記本做 query / create / delete;nlm cross query 用同一問題跨筆記本查詢。
**5. 不安裝就用 uvx。**臨時試用或 CI 環境,用 uvx --from notebooklm-mcp-cli ... 免安裝直接執行。
最該讀的三份官方文件
① GETTING_STARTED.md——安裝、登入、代理註冊與遷移路徑。 ② CLI_GUIDE.md——完整的 nlm 指令參考。 ③ MCP_GUIDE.md——35 個 MCP 工具的說明與範例。
這專案由一個非開發者借助 AI 編程助手完成。 如果你看到讓你皺眉的地方, 歡迎貢獻,而不只是關掉分頁。