jacob-bd/gemini-notebook-mcp-cli

Gemini Notebook（前稱 Google NotebookLM）CLI 與 MCP 伺服器

這是什麼 – 一個 Python 套件，可讓您透過命令列或 Model Context Protocol (MCP) 伺服器 控制 Google 的 Gemini Notebook（先前稱為 Notebook LM）。MCP 伺服器可與 AI 助理工具（如 Claude、Cursor、Gemini‑CLI、GitHub Copilot 等）連接，讓這些代理程式能自動讀取、寫入並在您的 Gemini Notebook 中產生內容。

主要功能

區域	CLI 命令（範例）	MCP 工具名稱
列出筆記本	nlm notebook list	notebook_list
建立筆記本	nlm notebook create "Research Project"	notebook_create
新增來源（URL、文字、Drive 檔案、上傳）	nlm source add <nb> --url "https://…"	source_add
查詢筆記本（在網頁介面新增對話項目）	nlm notebook query "Summarize key points"	notebook_query
管理對話會話	nlm chats list / nlm chats get <id>	chat_list, chat_get
產生 Studio 內容（音訊、影片、簡報、圖表等）	nlm studio create <nb> audio	studio_create
修訂簡報投影片	nlm slides revise <nb>	studio_revise
下載成果物	nlm download audio <nb> <artifact-id>	download_artifact
批次下載所有成果物	nlm download all <nb> -d ./exports	download_all_artifacts
同步 Drive 來源	nlm source sync	source_sync_drive
批次操作、跨筆記本查詢、工作流程、標籤等	nlm batch …, nlm cross query …, nlm pipeline run …, nlm tag add …	batch, cross_notebook_query, pipeline, tag
分享筆記本（公開連結或邀請）	nlm share public <nb>	notebook_share_*
設定 AI 工具（Claude、Cursor、Gemini‑CLI 等）	nlm setup add claude-code	–
安裝「技能」，教導助理如何使用 MCP	nlm skill install cline	–
診斷問題	nlm doctor	–

如何使用

1. 安裝 – pip install notebooklm-mcp-cli（或建議的 uv tool install notebooklm-mcp-cli）。
2. 登入 – nlm login 會開啟瀏覽器，提取 Google Cookie 並本地儲存。使用使用者設定檔可同時管理多個 Google 帳號。
3. 執行 CLI – nlm … 可讓您撰寫腳本，自動完成筆記本建立、來源新增、內容產生、下載、分享等操作。
4. 啟動 MCP 伺服器 – notebooklm-mcp 會啟動一個本地 HTTP 伺服器，讓 AI 助理可以呼叫。透過 nlm setup add <tool>，套件會自動產生對應的 JSON 設定檔，讓 Claude Desktop、Cursor、GitHub Copilot 等工具能呼叫內建的 43 個 MCP 工具。
5. 與您的助理對話 – 一旦 MCP 註冊完成，您只需說出像 「建立一個關於量子運算的筆記本並產生播客」 之類的指令，助理就會在背後自動呼叫適當的 MCP 端點。

安裝與升級

• 推薦方式：uv tool install notebooklm-mcp-cli（或使用 uvx 進行一次性執行）。
• 亦可透過 pip / pipx 安裝。
• 升級方式相同（uv tool upgrade … 或 pip install --upgrade …）。
• 安裝統一套件前，必須先移除舊版套件（notebooklm-cli、notebooklm-mcp-server）。

安全提醒 – 此工具會連接 未公開的 Google 內部 API，並需要您從瀏覽器匯出 Cookie。這些 API 可能隨時變更，因此本套件僅適用於個人或實驗性用途。

適用對象 – 開發者、研究人員或進階使用者，希望以程式化或 AI 代理程式方式存取 Gemini Notebook，執行自動化研究整合、內容產生（音訊、影片、簡報、圖表等）、批量匯出或無需手動操作網頁介面即可分享筆記本等任務。

---

快速入門範例

# 安裝
uv tool install notebooklm-mcp-cli

# 登入（開啟瀏覽器，提取 Cookie）
nlm login

# 建立筆記本並新增來源
nlm notebook create "AI Strategy"
nlm source add "AI Strategy" --url "https://arxiv.org/abs/2302.12345"

# 請筆記本總結內容
nlm notebook query "Summarize the main findings"

# 產生播客並下載
nlm studio create "AI Strategy" audio
nlm download all "AI Strategy" -d ./exports

MCP 註冊範例（適用於 Claude Desktop）

nlm setup add claude-code   # 將所需 JSON 寫入 Claude 的設定檔

現在 Claude 可以執行如 @gemini-notebook-mcp notebook_create "My Notebook" 之類的指令。

---

資源

• 完整文件：docs/GETTING_STARTED.md、docs/CLI_GUIDE.md、docs/MCP_GUIDE.md
• README 中連結的示範影片，展示 CLI 使用方式與與各類助理的 MCP 整合。
• 套件已發佈於 PyPI，名稱為 notebooklm-mcp-cli。