AI导哈

NotebookLM MCP服务器

NotebookLM MCP服务器是一个将Google NotebookLM作为工具暴露给任何MCP兼容客户端的服务。

  • by PavelGuzenfeld
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 PavelGuzenfeld/notebooklm-mcp

使用说明

NotebookLM MCP服务器

MCP服务器，将Google NotebookLM作为任何MCP兼容客户端的工具公开。

建于 笔记本 （非官方SDK）。

快速入门（逐步）

步骤1：安装

# Clone or navigate to the project
cd notebooklm-mcp

# Option A: using uv (recommended)
uv venv .venv && source .venv/bin/activate && uv pip install -e .

# Option B: using pip
python3 -m venv .venv && source .venv/bin/activate && pip install -e .

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

notebooklm-auth

这将显示：

╔══════════════════════════════════════════════════════════════╗
║           NotebookLM CLI Authentication                     ║
╚══════════════════════════════════════════════════════════════╝

Open this URL in your browser and log in:

  https://notebooklm.google.com/

然后按照以下步骤操作：

  1. 打开 https://notebooklm.google.com/ 在浏览器中
  2. 使用您的Google帐户登录
  3. 打开 开发者工具 （按 F12)
  4. 去 网络 标签
  5. 刷新页面(F5)
  6. 右键单击第一个请求(notebooklm.google.com)
  7. 点击 复制 > 复制为cURL
  8. 粘贴到终端，按两次Enter键

步骤3：验证身份验证

notebooklm-auth --verify

预期产量：

Auth file: ~/.notebooklm/storage_state.json
Cookies: <N> found
Verifying against https://notebooklm.google.com/ ...
CSRF token: <token>...
Session ID: <session_id>...

Authentication is VALID.

步骤4：连接到MCP客户端

看 客户端配置 下面是您的特定工具。

步骤5：开始使用NotebookLM工具

连接后，您可以使用31个工具中的任何一个——列出笔记本、添加资源、提问、生成播客等等。

跑步

stdio（默认值--用于本地MCP客户端）

notebooklm-mcp

HTTP（用于远程客户端、web UI、多客户端设置）

notebooklm-mcp --transport streamable-http --port 8484

SSE（服务器发送事件）

notebooklm-mcp --transport sse --port 8484

客户端配置

克劳德代码

claude mcp add notebooklm -- notebooklm-mcp

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "notebooklm": {
      "command": "notebooklm-mcp"
    }
  }
}

风帆/继续/坚持

添加到MCP配置中：

{
  "mcpServers": {
    "notebooklm": {
      "command": "notebooklm-mcp"
    }
  }
}

HTTP客户端（任何语言/工具）

# Start the server
notebooklm-mcp --transport streamable-http --port 8484

# Connect from any MCP client at:
#   http://localhost:8484/mcp

可用工具（31）

笔记本

工具 说明
notebook_list 列出所有笔记本
notebook_create 创建新笔记本
notebook_get 获取笔记本详细信息
notebook_delete 删除笔记本
notebook_rename 重命名笔记本
notebook_summary 获取AI生成的摘要

来源

工具 说明
source_list 在笔记本中列出来源
source_add_url 添加URL或YouTube链接
source_add_text 添加粘贴的文本
source_add_file 上传本地文件（PDF、markdown、docx）
source_get 获取源详细信息
source_delete 删除源
source_fulltext 获取提取的文本
source_guide 获取源的AI摘要

聊天

工具 说明
chat_ask 询问有关笔记本来源的问题
chat_history 获取对话历史记录
chat_configure 设置聊天目标、长度或自定义提示

人工制品

工具 说明
artifact_list 列出生成的工件
artifact_generate_audio 生成播客/音频概述
artifact_generate_report 生成报告
artifact_generate_study_guide 生成学习指南
artifact_generate_quiz 生成测验
artifact_generate_flashcards 生成抽认卡
artifact_generate_mind_map 生成思维导图
artifact_download_audio 下载音频文件
artifact_poll_status 检查发电状态
artifact_delete 删除工件

研究

工具 说明
research_start 开始网络或Drive研究
research_poll 检查研究状态

共享

工具 说明
sharing_status 获取共享状态
sharing_set_public 切换公共/私人

认证

两种选择——无需剧作家：

选项1：交互式CLI（推荐）

notebooklm-auth

打开从浏览器的DevTools复制Cookie的说明。支持：

  • 复制为cURL（在“网络”选项卡中右键单击）
  • 原始Cookie标头
  • 从浏览器扩展导出JSON

选项2：环境变量

export NOTEBOOKLM_AUTH_JSON='{"cookies":[{"name":"SID","value":"...","domain":".google.com","path":"/","expires":-1,"httpOnly":true,"secure":true,"sameSite":"None"}]}'
notebooklm-mcp

验证身份验证

notebooklm-auth --verify

Cookie存储在 ~/.notebooklm/storage_state.json 并定期到期。

注意事项

  • 使用未记录的Google API——可能会在不通知的情况下中断
  • 不隶属于谷歌
  • 大量使用可能会触发速率限制
  • 用于个人/研究用途，而非生产

相关 MCP