Notebook Lm MCP

适用于Claude的NotebookLM MCP（桌面和CLI）

一个强大的MCP（模型上下文协议）服务器，将Google NotebookLM引入Claude Desktop和Claude Code。

特性

• 研究：列出并创建笔记本
• 内容：添加URL、文本和文件作为源
• 生成：创建播客、视频、幻灯片、思维导图、信息图、测验、抽认卡和报告
• 自然交互：使用克劳德的推理直接与您的消息来源聊天

______________________________________________________________________

先决条件

1.安装uv（Python包管理器）

macOS / Linux

# Using curl
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with Homebrew (macOS)
brew install uv

默认安装位置： ~/.local/bin/uv

Windows

# Using PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or with Scoop
scoop install uv

# Or with winget
winget install --id=astral-sh.uv -e

默认安装位置： %USERPROFILE%\.local\bin\uv.exe

验证安装：

uv --version

2.克隆和安装依赖项

# Clone the repository
git clone https://github.com/alfredang/notebooklm-mcp.git

# Navigate to the project folder
cd notebooklm-mcp

# Install dependencies (includes notebooklm-py and fastmcp)
uv sync

这将：

• 创建 .venv 虚拟环境
• 安装 笔记本 （用于NotebookLM API的Python客户端）
• 安装 fastmcp （MCP服务器框架）

注： Claude Desktop和Claude Code都需要这些依赖关系。

______________________________________________________________________

步骤1：使用NotebookLM进行身份验证

NotebookLM使用基于浏览器的身份验证。您必须登录一次才能保存会话Cookie。

cd notebooklm-mcp
uv run notebooklm login

发生了什么：

1. 浏览器窗口将自动打开
2. 登录您的Google帐户
3. 如果未自动重定向，请导航到NotebookLM
4. 等待终端显示 “成功”
5. 关闭浏览器

验证身份验证：

uv run python -c "
from notebooklm import NotebookLMClient
import asyncio
async def test():
    client = await NotebookLMClient.from_storage()
    async with client:
        notebooks = await client.notebooks.list()
        print(f'Authenticated! Found {len(notebooks)} notebooks.')
asyncio.run(test())
"

您应该看到： Authenticated! Found X notebooks.

______________________________________________________________________

步骤2：测试MCP服务器

在配置Claude之前，请验证服务器是否正确启动：

cd notebooklm-mcp
uv run python server.py

预期产量：

Starting NotebookLM MCP server...
NotebookLM client initialized successfully
Starting MCP server 'NotebookLM' with transport 'stdio'

按 Ctrl+C （或 Cmd+C 在Mac上）确认服务器正常工作后停止服务器。

______________________________________________________________________

步骤3：设置Claude桌面

3.1找到你的路

配置需要两条路径：

找到你的 uv 路径：

macOS / Linux

which uv

输出示例： /Users/yourname/.local/bin/uv

Windows

where uv

输出示例： C:\Users\yourname\.local\bin\uv.exe

查找您的项目路径：

macOS / Linux

cd notebooklm-mcp && pwd

输出示例： /Users/yourname/projects/notebooklm-mcp

Windows

cd notebooklm-mcp; (Get-Location).Path

输出示例： C:\Users\yourname\projects\notebooklm-mcp

3.2打开配置文件

来自克劳德桌面（推荐）：

1. 打开克劳德桌面
2. 首选 设置 （齿轮图标）→ 开发者 → 编辑配置
3. 这将打开 claude_desktop_config.json 在默认编辑器中

或手动：

macOS path

~/Library/Application Support/Claude/claude_desktop_config.json

Windows path

%APPDATA%\Claude\claude_desktop_config.json

3.3添加MCP服务器配置

重要提示： 替换 ` 和

` 使用步骤3.1中的实际路径

macOS / Linux Configuration

{
  "mcpServers": {
    "notebooklm": {
      "command": "",
      "args": [
        "--directory",
        "
",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

实路径示例：

{
  "mcpServers": {
    "notebooklm": {
      "command": "/Users/yourname/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/yourname/projects/notebooklm-mcp",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

Windows Configuration

{
  "mcpServers": {
    "notebooklm": {
      "command": "",
      "args": [
        "--directory",
        "
",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

实路径示例：

{
  "mcpServers": {
    "notebooklm": {
      "command": "C:\\Users\\yourname\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\yourname\\projects\\notebooklm-mcp",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

注： 在Windows上，使用双反斜杠(\\)JSON路径中。

3.4重新启动克劳德桌面

寻找 锤图标 在聊天输入区域中，这表示MCP工具可用。

3.5验证连接

在Claude Desktop中，键入：

List my NotebookLM notebooks

克劳德应该使用 list_notebooks 工具并显示您的笔记本。

______________________________________________________________________

步骤4：设置Claude代码（CLI）

先决条件： 首先完成步骤1-2（使用安装依赖项 uv sync 并通过以下方式进行身份验证 uv run notebooklm login).

4.1添加MCP服务器

替换 使用您的实际项目路径：

macOS / Linux

claude mcp add notebooklm -- uv --directory 
 run python server.py

例子：

claude mcp add notebooklm -- uv --directory /Users/yourname/projects/notebooklm-mcp run python server.py

Windows

claude mcp add notebooklm -- uv --directory 
 run python server.py

例子：

claude mcp add notebooklm -- uv --directory C:\Users\yourname\projects\notebooklm-mcp run python server.py

4.2验证服务器是否已添加

claude mcp list

你应该看看 notebooklm 在列表中。

4.3克劳德代码测试

启动新的Claude Code会话：

claude

然后问：

List my NotebookLM notebooks

______________________________________________________________________

用法示例

配置后，使用Claude Desktop或Claude Code中的自然语言命令：

______________________________________________________________________

可用工具

______________________________________________________________________

故障排除

“服务器已断开连接”或“生成进程失败”

原因：克劳德桌面找不到 uv 因为它没有继承shell的PATH。

解决方案：使用 完全绝对路径 到 uv 在配置中（参见步骤3.1）。

______________________________________________________________________

“找不到命令：uv”

macOS / Linux

添加到您的shell配置文件(~/.zshrc 或 ~/.bashrc):

export PATH="$HOME/.local/bin:$PATH"

然后重新加载：

source ~/.zshrc  # or source ~/.bashrc

Windows

添加到您的路径：

1. 开放系统属性→ 环境变量
2. 在“用户变量”下，编辑 Path
3. 添加： %USERPROFILE%\.local\bin
4. 重新启动终端

______________________________________________________________________

MCP服务器未出现在Claude桌面中

原因：配置文件中的JSON无效或Claude未正确重新启动。

解决方案:

1. 在以下位置验证JSONhttps://jsonlint.com/
2. 确保JSON中没有尾随逗号
3. 完全退出并重新打开Claude Desktop

______________________________________________________________________

“NotebookLM客户端未初始化”

原因：服务器在身份验证完成之前启动。

解决方案:

1. 跑 uv run notebooklm login 第一
2. 重新启动Claude Desktop或在Claude Code中重新添加MCP服务器

______________________________________________________________________

检查克劳德桌面日志

macOS

# View recent logs
tail -100 ~/Library/Logs/Claude/mcp*.log

# Or open in Finder
open ~/Library/Logs/Claude/

Windows

# View logs folder
explorer "$env:APPDATA\Claude\logs"

______________________________________________________________________

删除和重新添加MCP服务器（克劳德代码）

如果问题仍然存在：

claude mcp remove notebooklm
claude mcp add notebooklm -- uv --directory 
 run python server.py

______________________________________________________________________

更新中

要更新NotebookLM库，请执行以下操作：

cd notebooklm-mcp
uv sync --upgrade

______________________________________________________________________

项目结构

notebooklm-mcp/
├── server.py          # MCP server implementation
├── pyproject.toml     # Project dependencies
├── README.md          # This file
├── SKILL.md           # Claude Code skill definition
└── .venv/             # Virtual environment (auto-created)

______________________________________________________________________

许可证

MIT许可证