使用说明

适用于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

发生了什么：

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

验证身份验证：

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打开配置文件

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

打开克劳德桌面
首选设置（齿轮图标）→ 开发者 → 编辑配置
这将打开 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服务器配置

重要提示： 替换 <UV_PATH> 和 <PROJECT_PATH> 使用步骤3.1中的实际路径

macOS / Linux Configuration

{
  "mcpServers": {
    "notebooklm": {
      "command": "<UV_PATH>",
      "args": [
        "--directory",
        "<PROJECT_PATH>",
        "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": "<UV_PATH>",
      "args": [
        "--directory",
        "<PROJECT_PATH>",
        "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重新启动克劳德桌面

平台	如何重新启动
macOS	媒体 `Cmd+Q` 完全退出，然后重新打开
视窗	右键单击托盘图标→ 退出，然后重新打开

寻找 锤图标 在聊天输入区域中，这表示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服务器

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

macOS / Linux

claude mcp add notebooklm -- uv --directory <PROJECT_PATH> 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 <PROJECT_PATH> 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中的自然语言命令：

任务	命令示例
列出笔记本	“显示我的所有NotebookLM笔记本”
创建笔记本	“创建一个名为“研究项目”的新笔记本”
添加URL源	“将此URL添加到我的笔记本：https://example.com/article"
生成播客	“为笔记本ID xyz123生成播客”
创建幻灯片	“从我的‘研究项目’笔记本中制作幻灯片”
生成思维导图	“为笔记本abc456创建思维导图”
创建测验	“根据我的笔记本来源生成测验”
制作抽认卡	“从这个笔记本创建学习抽认卡”

可用工具

工具	说明
`list_notebooks`	列出您帐户中的所有笔记本
`create_notebook`	创建新笔记本
`add_source_url`	添加网站URL作为源
`add_source_text`	添加原始文本作为源
`ask_notebook`	根据笔记本来源提问
`get_notebook_summary`	获取摘要和关键见解
`generate_audio_overview`	生成播客风格的音频
`generate_video_overview`	生成视频概述
`generate_slide_deck`	生成PowerPoint风格的幻灯片
`generate_mind_map`	生成交互式思维导图
`generate_infographic`	生成可视化信息图
`generate_quiz`	生成测验问题
`generate_flashcards`	生成学习抽认卡
`generate_summary_report`	生成简报文件
`generate_data_table`	将数据提取到表中

故障排除

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

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

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

“找不到命令：uv”

macOS / Linux

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

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

然后重新加载：

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

Windows

添加到您的路径：

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

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

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

解决方案:

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

“NotebookLM客户端未初始化”

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

解决方案:

跑 uv run notebooklm login 第一
重新启动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 <PROJECT_PATH> 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许可证

使用说明

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

特性

先决条件

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

2.克隆和安装依赖项

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

步骤2：测试MCP服务器

步骤3：设置Claude桌面

3.1找到你的路

3.2打开配置文件

3.3添加MCP服务器配置

3.4重新启动克劳德桌面

3.5验证连接

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

4.1添加MCP服务器

4.2验证服务器是否已添加

4.3克劳德代码测试

用法示例

可用工具

故障排除

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

“找不到命令：uv”

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

“NotebookLM客户端未初始化”

检查克劳德桌面日志

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

更新中

项目结构

许可证

相关 MCP

网页内容抓取服务器

多模态生成API服务

Rhino与Grasshopper AI控制MCP服务

图表生成MCP服务器

Blender 3D建模MCP服务

Ableton Live AI音乐制作MCP服务器