技術筆記 / AI

在 Claude Code 中整合 NotebookLM MCP:完整安裝教學

適用對象: 已安裝 Claude Code CLI,且有 Google NotebookLM 帳號的使用者
工具版本: notebooklm-mcp-cli v0.5.x(2026年4月最新)


什麼是 NotebookLM MCP?

notebooklm-mcp-cli 是一個開源工具,讓 Claude Code(以及 Cursor、Gemini CLI 等 AI 工具)能夠直接操控 Google NotebookLM。透過這個 MCP,你可以用自然語言指揮 Claude Code:

⚠️ 免責聲明: 此工具使用 NotebookLM 的非官方內部 API,可能隨時失效,僅供個人實驗使用。


前置需求

需求 說明
Python 3.10+ 確認:python3 --version
uv 套件管理工具 安裝:curl -LsSf https://astral.sh/uv/install.sh \| sh
Claude Code CLI 已安裝並登入
Google 帳號 有使用 NotebookLM 的帳號

步驟一:安裝套件

推薦使用 uv(速度快、環境乾淨):

uv tool install notebooklm-mcp-cli

安裝完成後,確認兩個執行檔都存在:

nlm --version
notebooklm-mcp --version

應看到類似輸出:

notebooklm-mcp-cli v0.5.26

步驟二:Google 帳號認證

MCP 需要取得你的 NotebookLM cookie 才能操作,執行登入指令:

nlm login

這會自動開啟一個瀏覽器視窗,完成 Google 登入後,cookie 會自動擷取並儲存。

確認認證成功:

nlm login --check

多帳號支援: 如果你有多個 Google 帳號,可以用 profile 管理:

bash nlm login --profile work nlm login --profile personal nlm login profile list


步驟三:將 MCP 加入 Claude Code

有兩種方式,擇一即可。

方法 A:使用 nlm setup(最簡單,推薦)

nlm setup add claude-code

這個指令會自動偵測 Claude Code 的設定路徑並寫入,不需要手動編輯 JSON。

方法 B:手動用 claude mcp add-json

# User scope(所有專案都可用)
claude mcp add-json notebooklm-mcp \
  '{"command":"uvx","args":["--from","notebooklm-mcp-cli","notebooklm-mcp"]}' \
  --scope user

# 或 Project scope(只在目前專案)
claude mcp add-json notebooklm-mcp \
  '{"command":"uvx","args":["--from","notebooklm-mcp-cli","notebooklm-mcp"]}' \
  --scope project

Scope 選擇建議:

Scope 使用時機 設定位置
user 個人常用工具,所有專案都要 ~/.claude.json
project 只在特定專案用,可 commit ./.mcp.json
local 個人用、只在這個專案(預設) ~/.claude.json(含 project path)

步驟四:確認連線

重新啟動 Claude Code,或在 session 內執行:

/mcp

看到 notebooklm-mcp: connected 即表示成功。


步驟五:開始使用

MCP 連線後,直接用自然語言跟 Claude Code 說話即可:

基本操作

列出我所有的 NotebookLM Notebooks
建立一個新的 Notebook,名稱叫「AI 研究筆記」
把這個 URL 加到我的 Notebook:https://example.com/article

查詢與分析

這個 Notebook 的主要內容是什麼?請幫我摘要
搜尋 Notebook 裡關於「機器學習」的部分

內容生成

幫我從這個 Notebook 生成一個 Podcast 音訊
製作一個簡報 Slide Deck,主題是這個 Notebook 的研究成果
建立 Flashcard,難度設中等

管理與分享

把這個 Notebook 設成公開連結
同步我 Google Drive 裡的來源,更新過期的文件

常見問題

Q:認證過期怎麼辦?

Cookie 有效期約 2-4 週,失效時重新執行:

nlm login

MCP 本身在遇到認證錯誤時會嘗試自動重新整理 token,如果自動刷新失敗才需要手動重新登入。

Q:升級到最新版本

# 如果 upgrade 沒裝到最新版,用 force 強制重裝
uv tool install --force notebooklm-mcp-cli

升級後在 Claude Code 內執行 /mcp 重新連線。

Q:MCP 工具太多(35 個)佔用 context 怎麼辦?

不使用 NotebookLM 時記得關閉這個 MCP,在 Claude Code session 內:

@notebooklm-mcp

可以切換開關狀態。

Q:診斷安裝問題

nlm doctor

這個指令會自動偵測安裝狀態、認證狀態、以及各 AI 工具的設定是否正確。


完整移除

# 移除套件
uv tool uninstall notebooklm-mcp-cli

# 從 Claude Code 移除設定
nlm setup remove claude-code

# 刪除認證資料(可選)
rm -rf ~/.notebooklm-mcp-cli

參考資源

在 GitHub 看原文