N
Notebooklm MCP
作者 @rasvet7535
MCP server for Google NotebookLM via Playwright + Firefox
创建于 5/21/2026
更新于 about 18 hours ago
README
Repository documentation and setup instructions
NotebookLM MCP Server
MCP-сервер для Google NotebookLM.
Visible Bridge Mode: Firefox + ваш профиль + SandVPN + сохранённая сессия.
Возможности
- ask_notebooklm(query) — задать вопрос ноутбуку (через
?tab=chat) - notebooklm_status() — статус сессии (URL, размер тела, валидность)
- 403 recovery — автоматический retry при блокировках
- 90s timeout на ответ AI (Angular-рендеринг)
Быстрый старт
npm install
npx playwright install firefox
cp .env.example .env
1. Настройка сессии (первый запуск)
node setup-profile.mjs
Откроется Firefox в Visible Bridge Mode. Подключи SandVPN, войди в Google,
открой ноутбук Pygmalion, нажми Enter — сессия сохранится в storageState.json.
2. Запуск MCP-сервера
node server.js
Сервер восстановит сессию из storageState.json. Если сессия истекла —
переключится в visible-режим и будет ждать входа.
3. Подключение к OpenCode / Claude
{
"mcpServers": {
"notebooklm": {
"command": "node",
"args": ["path/to/server.js"],
"env": {
"NOTEBOOK_ID": "your-notebook-id"
}
}
}
}
Архитектура
Firefox (ваш профиль + SandVPN)
→ notebooklm.google.com
→ ?tab=chat (прямой вход в чат, обход 403)
→ ask_notebooklm (90s timeout, 403 recovery)
→ storageState.json (317+ cookies, OSID-токены)
Переменные окружения (.env)
| Переменная | Описание | По умолчанию |
|---|---|---|
| NOTEBOOK_ID | ID ноутбука | — |
| USER_DATA_DIR | Директория профиля Firefox | ./firefox-profile |
| STORAGE_FILE | Файл сохранённой сессии | storageState.json |
Лицензия
MIT
快速设置
此服务器的安装指南
安装包 (如果需要)
npx @modelcontextprotocol/server-notebooklm-mcp
Cursor 配置 (mcp.json)
{
"mcpServers": {
"rasvet7535-notebooklm-mcp": {
"command": "npx",
"args": [
"rasvet7535-notebooklm-mcp"
]
}
}
}