目前沒有官方的 NotebookLM API，但社群已開發出多個 MCP (Model Context Protocol) Server 與 Python SDK，透過瀏覽器自動化（Cookie 提取）反向工程 NotebookLM 的內部 RPC 介面，讓 AI Agent 可以把 NotebookLM 當作知識庫來查詢。以下是主要專案與你需要知道的所有資訊。
核心專案比較表
| 專案 | 語言/形式 | 星數 | 主要特色 | 適合對象 |
|---|---|---|---|---|
| PleasePrompto/notebooklm-mcp | TypeScript (MCP Server) | 448  |
純 MCP Server，支援 Codex、Claude Code、Cursor、Gemini CLI 等所有 MCP Client；內建 Library 管理、Profile 切換、多工具 Profile（minimal/standard/full） | 想要標準 MCP、跨多種 AI Tool 共用 |
| jacob-bd/notebooklm-mcp-cli | Python (CLI + MCP Server 合一) | 4.7k |
功能最完整；單一套件同時提供 nlm CLI 與 notebooklm-mcp MCP Server；35 個 MCP Tools；支援 Deep Research、Cross-notebook query、Pipelines、Studio 內容生成（音訊/影片/簡報/心智圖/測驗）、Drive 同步、批次操作、Tag/智能選擇 |
需要完整功能、CLI 自動化、Hermes Agent 整合 |
teng-lin/notebooklm-py (PyPI: notebooklm-py) |
Python SDK + CLI + Agent Skills | - | 非官方 Python API 最完整；可直接 import 在 Python 程式中使用；支援所有 NotebookLM 功能（含 Web UI 沒有的批次下載、Quiz/Flashcard 匯出、Mind Map JSON、PPTX 下載、Slide 修訂）；內建 notebooklm skill install 可一鍵安裝到 Claude Code、Codex、OpenClaw |
要在自訂 Python 程式/管線中嵌入、或需要 Web UI 沒有的進階匯出功能 |
| alfredang/notebooklm-mcp | Python (MCP Server) | - | 專為 Claude Desktop/CLI 設計；支援建立筆記本、管理來源、生成播客/影片/投影片/心智圖/測驗 | 專注於 Claude 生態 |
| tmc/nlm | Go (CLI + MCP Server) | - | 單一二進位檔，Shell script 友善，依靠 exit code 分支 | 偏好 Go/單一執行檔、Shell 自動化 |
| moodRobotics/notebooklm-mcp-server | - | - | 通用安裝腳本與設定指南 | 想要快速部署指引 |
| Pantheon-Security/notebooklm-mcp-secure | - | - | 14 層安全強化（適合企業/生產環境） | 有安全合規需求 |
三大主流整合方式
1. MCP Server 模式（推薦：跨工具通用）
所有主流 AI Coding Agent 都支援 MCP，只要在各工具的設定檔加入 MCP Server 即可。
OpenAI Codex
# 一鍵安裝（推薦用 PleasePrompto 版）
codex mcp add notebooklm -- npx notebooklm-mcp@latest
# 或用 jacob-bd 版（功能更多）
codex mcp add notebooklm -- uvx --from notebooklm-mcp-cli notebooklm-mcp
- Codex v0.4.5+ 已官方支援 NotebookLM MCP（含 Cinematic Video） reddit
- 設定後在 Codex 聊天中說
\"Log me in to NotebookLM\"即可啟動瀏覽器登入 simplified
Claude Code / Claude Desktop
# Claude Code
claude mcp add notebooklm npx notebooklm-mcp@latest
# Claude Desktop：編輯 ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"notebooklm": { "command": "npx", "args": ["-y", "notebooklm-mcp@latest"] }
}
}
Cursor / Windsurf / Gemini CLI / GitHub Copilot (VS Code)
// ~/.cursor/mcp.json 或 ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"notebooklm": { "command": "npx", "args": ["-y", "notebooklm-mcp@latest"] }
}
}
jacob-bd版提供nlm setup add cursor/nlm setup add gemini等自動設定指令 github
Hermes Agent
- Hermes Agent 可透過 Skill 系統 整合 NotebookLM summree
- 安裝方式：下載 NotebookLM Skill 檔 → 上傳到 Claude Code → 用瀏覽器 Cookie 登入 → 加入 Hermes Pantheon 儀表板建立 Persona summree
- 也可用
notebooklm-py的notebooklm skill install一鍵安裝到 Hermes/OpenClaw pypi
2. Python SDK 直接嵌入（適合自訂管線、非互動式自動化）
pip install "notebooklm-py[browser]" # 含 Playwright 自動登入
playwright install chromium
notebooklm login # 開啟瀏覽器登入 Google
import asyncio
from notebooklm import NotebookLMClient
async def main():
async with await NotebookLMClient.from_storage() as client:
# 建立筆記本並加入來源
nb = await client.notebooks.create("Research")
await client.sources.add_url(nb.id, "https://example.com", wait=True)
# 問答（RAG 查詢）
result = await client.chat.ask(nb.id, "Summarize this")
print(result.answer) # 含引用來源
# 生成內容
status = await client.artifacts.generate_audio(nb.id, instructions="make it fun")
await client.artifacts.wait_for_completion(nb.id, status.task_id)
await client.artifacts.download_audio(nb.id, "podcast.mp3")
asyncio.run(main())
- 完整 API 參考：
notebooklm-py文件 pypi - 優勢：不需 MCP 協議、可直接寫在 Python 管線、支援 Web UI 沒有的功能（批次下載、Quiz/Flashcard JSON/MD/HTML 匯出、Mind Map JSON、PPTX 下載、Slide 修訂） pypi
3. CLI 直接腳本化（適合 CI/CD、Shell 自動化）
# jacob-bd 版（功能最全）
uv tool install notebooklm-mcp-cli
nlm login # 瀏覽器登入
nlm notebook create "My Project"
nlm source add <notebook_id> --url "https://arxiv.org/abs/xxxx"
nlm notebook query <notebook_id> "關鍵發現是什麼？"
nlm studio create <notebook_id> --type audio --format deep-dive --wait
nlm download audio <notebook_id> ./podcast.mp3
notebooklm-py版 CLI 指令相似：notebooklm create/notebooklm ask/notebooklm generate audio/notebooklm download audiopypi
認證機制（所有專案通用）
| 方式 | 說明 | 適用場景 |
|---|---|---|
| Auto 模式 | 啟動專用 Chrome/Chromium/Brave/Edge/Arc，手動登入 Google，自動提取 Cookie 存入本地 | 本機開發、有桌面環境 |
| Manual 模式 | 從瀏覽器 DevTools 複製 Cookie Header，貼入 CLI/工具 |
無頭伺服器、CI/CD、Docker |
| Profile 管理 | 支援多 Google 帳號切換（nlm login --profile work / personal） |
多專案、多帳號 |
| External CDP | 連接外部管理的瀏覽器（如 OpenClaw）--provider openclaw --cdp-url http://127.0.0.1:18800 |
企業級瀏覽器編排 |
關鍵限制與風險（必讀）
| 項目 | 說明 |
|---|---|
| 非官方 API | 皆為逆向工程內部 RPC，Google 可隨時變更導致失效 github |
| 免費額度限制 | 約 50 queries/天/帳號；Google AI Ultra（$249/月）額度較高 github |
| Cookie 過期 | 定期需重新登入；自動刷新機制不保證 100% 成功 |
| 安全性 | Cookie 存本地（~/.notebooklm-mcp/auth.json 或 ~/.notebooklm-mcp-cli），請妥善保護 |
| 無 SLA | 適合原型、研究、個人專案；不建議用於生產關鍵系統 pypi |
| CRI (Code Retrieval Interface) | 目前無專案實作 CRI 協議；皆以 MCP 為主流標準 |
快速選型建議
| 你的需求 | 推薦方案 |
|---|---|
| 只要在 Codex/Claude Code/Cursor 裡問問題、要零設定 | codex mcp add notebooklm -- npx notebooklm-mcp@latest（PleasePrompto 版） |
| 要完整功能（Deep Research、Studio 產出、Cross-notebook、Pipeline、Tag） | uv tool install notebooklm-mcp-cli（jacob-bd 版） |
| 要寫 Python 程式/管線嵌入、或要 Web UI 沒有的匯出功能 | pip install "notebooklm-py[browser]" 直接 import 使用 |
| Hermes Agent 整合 | notebooklm skill install → Hermes Pantheon 加 Persona summree |
| 企業/安全要求高 | Pantheon-Security/notebooklm-mcp-secure（14 層強化） |
| 單一二進位檔、Shell 腳本友善 | tmc/nlm (Go) |
相關資源連結彙整
總結
有現成可用的專案，且已相當成熟，主要透過 MCP 協議讓 OpenAI Codex、Hermes Agent、Claude Code、Cursor、Gemini CLI 等 Agent 直接把 NotebookLM 當作 RAG 知識庫查詢。最推薦的兩條路徑：
- MCP Server 路徑：
codex mcp add notebooklm -- npx notebooklm-mcp@latest→ 30 秒完成、跨所有 MCP Client 通用 - Python SDK 路徑：
pip install "notebooklm-py[browser]"→ 最大彈性、可嵌入自訂管線、支援最多進階功能
提醒：皆為社群非官方實作，請用專用 Google 帳號，並預期 API 可能隨時失效。若需企業級穩定性，建議改用 Vertex AI RAG Engine 或 Gemini API + 自建向量資料庫。