NotebookLM MCP — Claude Code, Claude Desktop, Cursor, Cline, Continue

Sterowanie Google NotebookLM z dowolnego klienta MCP. Zero ręcznego loginu — wykorzystuje sesję Twojego Chrome'a.

Fork alfredang/notebooklm-mcp z 12 dodatkowymi narzędziami, auto-refresh cookies i naprawami zgodności z notebooklm-py>=0.3.4.

Co potrafi

27 narzędzi MCP:

Co odróżnia od upstream

• Cross-platform auth — import_chrome_cookies.py (macOS — Keychain bypass, zero loginu) lub login_interactive.py (Windows/Linux — Playwright headless login z manualnym podaniem hasła).
• Lazy server + auto-refresh + per-call retry — gdy Google zrotuje cookies, MCP sam pobiera świeże i ponawia. Bez restartu Claude Code.
• +12 narzędzi vs 15 w upstream (źródła plików/Drive, 9× download, wait utility).
• 3 bug fixy zgodności z aktualnym notebooklm-py>=0.3.4 (sources_count, AskResult.answer/references, wymagane params w generate_infographic).

Pełna lista zmian: CHANGELOG.md.

Wymagania

Kompatybilność OS × metoda auth

Instalacja

macOS — 4 komendy

# 1. Sklonuj
git clone https://github.com/studiogo/notebooklm-mcp ~/Documents/Projekty/notebooklm-mcp
cd ~/Documents/Projekty/notebooklm-mcp

# 2. Zainstaluj zależności
uv sync

# 3. Pobierz cookies sesji z Twojego Chrome (raz, akceptuj Keychain prompt)
uv run python scripts/import_chrome_cookies.py

# 4. Test (lista Twoich notebooków)
uv run notebooklm list

Windows — 5 komend (PowerShell)

# 1. Sklonuj
git clone https://github.com/studiogo/notebooklm-mcp $env:USERPROFILE\notebooklm-mcp
cd $env:USERPROFILE\notebooklm-mcp

# 2. Zainstaluj zależności + Playwright extra
uv sync --extra playwright

# 3. Zainstaluj browser dla Playwright (raz)
uv run playwright install chromium

# 4. Otwórz Chromium i zaloguj się ręcznie (login + hasło + 2FA)
uv run python scripts/login_interactive.py

# 5. Test
uv run notebooklm list

Linux — 5 komend

git clone https://github.com/studiogo/notebooklm-mcp ~/notebooklm-mcp
cd ~/notebooklm-mcp
uv sync --extra playwright
uv run playwright install chromium
uv run python scripts/login_interactive.py
uv run notebooklm list

Jeśli notebooklm list wylistuje Twoje notebooki — auth działa. Pora podpiąć MCP do klienta.

Podłączenie do klienta MCP

Pełne instrukcje per klient: INSTALL.md.

Claude Code (skrót):

claude mcp add notebooklm -- uv --directory ~/Documents/Projekty/notebooklm-mcp run python server.py

Claude Desktop: edycja ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notebooklm": {
      "command": "uv",
      "args": ["--directory", "/Users/TWOJ_USER/Documents/Projekty/notebooklm-mcp", "run", "python", "server.py"]
    }
  }
}

Po restarcie klienta — narzędzia mcp__notebooklm__* są dostępne.

Use case — Audio Overview po polsku

Ty: zrób mi notebook "Trendy AI 2026", znajdź 8 źródeł i wrzuć je tam,
    potem zrób z tego podcast po polsku 12-15 min.

Claude:
  1. WebSearch → 15 wyników
  2. filtruje top 8
  3. mcp__notebooklm__create_notebook("Trendy AI 2026")
  4. pętla mcp__notebooklm__add_source_url × 8
  5. mcp__notebooklm__generate_audio_overview(language="pl", instructions="...")
  6. mcp__notebooklm__wait_for_completion (~3 min)
  7. mcp__notebooklm__download_audio("~/Desktop/podcast.mp3")
  → masz gotowy 13-min podcast 2-osobowy AI w pliku MP3

Inne praktyczne flow:

• SmartLetter podcast — 5 newsów dnia → notebook → Audio Overview → automatyczny podcast bez nagrywania
• Lekcja kursu — skrypt + materiały → mind_map + quiz + flashcards → eksport
• Brand Brain — komplet researchu marki → ask z citations + briefing
• Research konkurencji — 10 stron + 5 YT + 3 PDF → cytowane odpowiedzi z całości

Refresh cookies (gdy MCP zwraca auth error)

Auto-refresh w server.py łapie większość przypadków. Gdy nie pomaga (np. Google wymaga 2FA re-auth):

cd ~/Documents/Projekty/notebooklm-mcp
uv run python scripts/import_chrome_cookies.py
# w kliencie MCP: /mcp reconnect notebooklm   (Claude Code)
# albo restart klienta (inne)

Cookies normalnie żyją tygodniami.

Troubleshooting

Authentication expired or invalid — odpal import_chrome_cookies.py. Jeśli nie pomaga, sprawdź czy Chrome ma aktywną sesję NotebookLM (otwórz https://notebooklm.google.com w przeglądarce).

No SID cookie found — żaden z profili Chrome nie ma zalogowanej sesji Google. Zaloguj się w Chrome do konta z dostępem do NotebookLM, odpal skrypt ponownie.

Generation failed - no artifact_id returned — typowo brak wymaganych parametrów (zwłaszcza w generate_infographic: orientation + detail_level). Sprawdź też czy Twój notebook ma źródła (puste notebooki nic nie wygenerują).

MCP server nie startuje — uv sync w katalogu repo. Sprawdź python --version (wymagane >=3.13). Sprawdź which uv.

Wywala 'Notebook' object has no attribute 'X' — pakiet notebooklm-py zmienił API. Update: uv lock --upgrade-package notebooklm-py && uv sync. Jeśli problem zostaje, otwórz issue.

Atrybucja

• Upstream: alfredang/notebooklm-mcp — bazowa struktura MCP wrappera
• Pakiet pod spodem: teng-lin/notebooklm-py — reverse-engineered klient NotebookLM RPC
• Cookies bypass: borisbabic/browser_cookie3

Zgłoszenia i zmiany

Znalazłeś błąd albo masz pomysł na narzędzie: otwórz zgłoszenie. Zanim to zrobisz, przejdź cztery kroki z CONTRIBUTING.md — połowa usterek to nieświeże ciasteczka albo stara wersja notebooklm-py.

W zgłoszeniu nie wklejaj ciasteczek, tokenów ani zawartości .env.

Zasady rozmowy: Kodeks postępowania.

Licencja

MIT — bezpłatne komercyjne i prywatne użytkowanie. Plik licencji zawiera też informację o pochodzeniu forka.

Autor forka: Łukasz Hodorowicz — Ogarniam AI