nblm-mcp

MCP-сервер, который дает AI-агенту доступ к Google NotebookLM (переименован в Gemini Notebook в июле 2026 года): создание и управление блокнотами, управление их источниками, задавание вопросов, на которые даются ответы из этих источников с цитатами, а также создание артефактов Studio, таких как аудиообзоры, брифинг-документы, викторины и интеллект-карты.

Смысл в обоснованности. NotebookLM отвечает только на основе предоставленного вами материала, поэтому агент, который может вызывать ask, получает ответы с цитатами из ваших собственных документов, а не догадывается — и это не тратит токены вашего собственного контекста, потому что Gemini выполняет чтение на стороне сервера.

⚠️ Неофициально — прочтите это в первую очередь

У Google нет публичного потребительского API для NotebookLM. Этот сервер использует те же частные веб-эндпоинты, которые вызывает интерфейс notebooklm.google.com, аутентифицируясь с помощью ваших собственных файлов cookie браузера, через библиотеку notebooklm-py под лицензией MIT.

• Не аффилирован с Google и не одобрен Google.

• Внутренний API может меняться без предупреждения и сломать этот сервер.

• Действуют лимиты скорости вашего аккаунта Google и ежедневные квоты Studio.

• Используйте аккаунт, с которым вам комфортно автоматизировать работу. Лучше всего подходит для личных проектов, исследований и прототипов.

Google документирует официальный API для Gemini Notebook Enterprise. Если у вас есть организация Workspace/Cloud с этой функцией, предпочтите его этому.

Установка

Пока нет на PyPI — устанавливайте прямо из этого репозитория. uvx собирает и запускает его по требованию, так что вручную обновлять ничего не нужно:

uvx --from git+https://github.com/Diego-Dev-Moros/nblm-mcp nblm-mcp

Related MCP server: NotebookLM MCP Server

Войдите один раз

Для входа требуется дополнительный пакет auth (Playwright) и человек за клавиатурой:

uvx --from "nblm-mcp[auth] @ git+https://github.com/Diego-Dev-Moros/nblm-mcp" nblm-mcp-login

Откроется окно браузера; войдите в NotebookLM как обычно. Файлы cookie сеанса сохраняются в ~/.notebooklm/ (та же структура профиля, которую использует notebooklm-py, так что существующий notebooklm login тоже работает). MCP-сервер никогда не входит в систему самостоятельно — ему нужен интерактивный браузер, который MCP-хост предоставить не может.

Если в Playwright еще нет браузера, сначала выполните playwright install chromium.

Cookie истекают. Когда это происходит, инструменты начинают возвращать ошибку аутентификации; выполните команду входа снова.

Подключите его к клиенту

Claude Code — -s user делает его доступным в каждом проекте:

claude mcp add notebooklm -s user -- \
  uvx --from git+https://github.com/Diego-Dev-Moros/nblm-mcp nblm-mcp

Claude Desktop — добавьте это в claude_desktop_config.json и перезапустите приложение (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\, Linux: ~/.config/Claude/):

{
  "mcpServers": {
    "notebooklm": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Diego-Dev-Moros/nblm-mcp", "nblm-mcp"]
    }
  }
}

Claude Desktop запускается из графического интерфейса, который не наследует PATH вашей оболочки. Если сервер не запускается там, замените "uvx" на его абсолютный путь (which uvx, обычно ~/.local/bin/uvx).

В любом случае убедитесь, что все работает, попросив агента вызвать auth_status.

Инструменты

Примечания о поведении

• Деструктивные инструменты защищены. delete_notebook и delete_source отказываются работать без confirm=true, так что случайный вызов инструмента не может уничтожить блокнот.

• Генерация медленная и ограничена квотой. generate_artifact возвращается, как только задача поставлена в очередь (wait=false, по умолчанию), и сообщает агенту опрашивать list_artifacts. Передайте wait=true, чтобы вместо этого блокировать; он ждет до NBLM_GENERATION_TIMEOUT секунд.

• Пути к файлам находятся на стороне сервера. add_source(file_path=...) и download_artifact читают и записывают на хосте, где работает MCP-сервер, который не обязательно находится там, где работает чат-клиент пользователя.

Конфигурация

Все опционально — см. .env.example. Файл .env в рабочем каталоге загружается, если он присутствует.

Разработка

uv venv && uv pip install -e ".[dev]"
uv run pytest
uv run ruff check src tests

Тестовый набор запускает инструменты против имитированного клиента в памяти — он никогда не обращается к Google, поэтому его безопасно и быстро запускать где угодно.

Предшественники

notebooklm-py выполняет сложную часть — реверс-инжиниринг и поддержку частного протокола batchexecute — и поставляет собственный, более крупный MCP-сервер. Этот проект — меньшая, узкоспециализированная поверхность инструментов поверх этой библиотеки: меньше инструментов, защита подтверждением для деструктивных операций и ответы с разрешенными цитатами.

Лицензия

MIT — см. LICENSE.