MCP Servers

A collection of Model Context Protocol servers, templates, tools and more.

MCP server for Google NotebookLM via Playwright + Firefox

Created 5/21/2026
Updated about 18 hours ago
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

Quick Setup
Installation guide for this server

Install Package (if required)

npx @modelcontextprotocol/server-notebooklm-mcp

Cursor configuration (mcp.json)

{ "mcpServers": { "rasvet7535-notebooklm-mcp": { "command": "npx", "args": [ "rasvet7535-notebooklm-mcp" ] } } }