notebooklm_mcp

NotebookLM MCP – koniec z halucynacjami od AI

Produktywność

NotebookLM MCP Server – opis

NotebookLM MCP Server to serwer MCP, który pozwala Twojemu asystentowi AI pracować z Google NotebookLM. Dzięki niemu możesz zadawać pytania do notatników, dodawać źródła i generować przeglądy audio. Serwer korzysta z prawdziwej przeglądarki Chrome, więc działa na rzeczywistym interfejsie NotebookLM. Możesz używać go między innymi z Claude Code, Cursor, Codex CLI oraz klientami MCP obsługującymi tryb stdio lub HTTP.
ℹ️ Info: W wersji 2.0.0 dostępny jest pełny zestaw narzędzi w profilu full.

Dostępne narzędzia

Pytania i odpowiedzi
  • ask_question – zadajesz pytanie do wybranego notatnika NotebookLM i otrzymujesz odpowiedź z opcjonalnymi źródłami.
Źródła i Studio
  • add_source – dodajesz źródło do notatnika jako adres URL lub wklejony tekst.
  • generate_audio – generujesz Audio Overview, czyli dźwiękowe omówienie materiałów z notatnika.
  • download_audio – zapisujesz najnowszy Audio Overview do wskazanego folderu.
Biblioteka notatników
  • add_notebook – dodajesz udostępniony adres URL notatnika do lokalnej biblioteki.
  • list_notebooks – wyświetlasz wszystkie notatniki zapisane w lokalnej bibliotece.
  • get_notebook – pobierasz dane jednego notatnika po jego identyfikatorze.
  • select_notebook – ustawiasz wybrany notatnik jako domyślny dla pytań.
  • update_notebook – aktualizujesz nazwę, opis, tematy, typy treści, zastosowania, tagi lub adres URL.
  • remove_notebook – usuwasz notatnik z lokalnej biblioteki bez kasowania go w NotebookLM.
  • search_notebooks – wyszukujesz notatniki po nazwie, opisie, tematach lub tagach.
  • get_library_stats – sprawdzasz liczbę notatników oraz statystyki użycia biblioteki.
Sesje przeglądarki
  • list_sessions – sprawdzasz aktywne sesje przeglądarki, ich wiek i liczbę wiadomości.
  • close_session – zamykasz konkretną sesję po jej identyfikatorze.
  • reset_session – resetujesz historię rozmowy, zachowując ten sam identyfikator sesji.
System i logowanie
  • get_health – sprawdzasz stan logowania, liczbę sesji i podstawową konfigurację serwera.
  • setup_auth – uruchamiasz pierwsze logowanie do konta Google w widocznym oknie Chrome.
  • re_auth – czyścisz zapisane logowanie i zaczynasz proces logowania od początku.
  • cleanup_data – usuwasz zapisane dane serwera z opcją zachowania pliku biblioteki.

Dostępne zasoby

  • notebooklm://library – odczytujesz lokalną bibliotekę zapisanych notatników NotebookLM.
  • notebooklm://library/{id} – odczytujesz dane konkretnego notatnika z lokalnej biblioteki.
  • notebooklm://metadata – odczytujesz metadane zachowane dla zgodności ze starszymi wersjami.

Najważniejsze możliwości

  • Możesz pytać AI o treści zapisane w Twoim notatniku NotebookLM.
  • Możesz dodawać źródła jako linki lub tekst wklejony bezpośrednio do notatnika.
  • Możesz generować i pobierać przeglądy audio przygotowane przez NotebookLM.
  • Możesz zarządzać lokalną biblioteką notatników i wybierać domyślny notatnik.
  • Możesz korzystać z cytowań w różnych formatach, między innymi jako przypisy lub dane JSON.

Jak działa NotebookLM MCP Server?

NotebookLM MCP Server działa jako most między Twoim asystentem AI a Google NotebookLM. W praktyce wygląda to tak: Ty → AI → serwer MCP → Google NotebookLM. Ty wydajesz polecenie w rozmowie z AI, a serwer MCP wykonuje odpowiednią akcję w NotebookLM przez przeglądarkę Chrome. Serwer korzysta z prawdziwego Chrome. Dzięki temu może logować się do NotebookLM, zadawać pytania do notatnika, dodawać źródła i odczytywać cytowania z interfejsu strony.
ℹ️ Info: Pierwsze logowanie wymaga widocznego okna Chrome. Po zalogowaniu serwer zapisuje profil przeglądarki i może używać go przy kolejnych uruchomieniach.

Typowy przepływ pracy

  1. Uruchamiasz serwer NotebookLM MCP w wybranym kliencie MCP.
  2. Logujesz się raz do swojego konta Google przez narzędzie setup_auth.
  3. Dodajesz notatnik do lokalnej biblioteki przez add_notebook.
  4. Wybierasz aktywny notatnik przez select_notebook.
  5. Zadajesz pytanie przez ask_question.
  6. AI otrzymuje odpowiedź z NotebookLM i może pokazać także źródła.

Jak wygląda praca z pytaniami?

Gdy pytasz AI o treść notatnika, serwer używa narzędzia ask_question. Pytanie trafia do NotebookLM, a odpowiedź wraca do rozmowy z AI. Możesz też określić format źródeł. Odpowiedź może być bez źródeł, ze źródłami w tekście, z przypisami albo jako uporządkowane dane JSON.
💡 Wskazówka: Używaj formatu źródeł, gdy chcesz sprawdzić, skąd NotebookLM wziął odpowiedź.

Przykłady użycia w praktyce

1. Zadajesz pytanie do konkretnego notatnika
Masz notatnik NotebookLM z dodanymi materiałami. Wybierasz go jako aktywny notatnik i pytasz AI o konkretną informację. Serwer przekazuje pytanie do NotebookLM. Następnie zwraca odpowiedź oraz, jeśli wybierzesz taki tryb, cytowania z panelu źródeł.
2. Dodajesz nowe źródło do notatnika
Możesz dodać źródło do NotebookLM jako adres URL albo wklejony tekst. Służy do tego narzędzie add_source. Po dodaniu źródła serwer zwraca liczbę źródeł przed i po zmianie. Dzięki temu widzisz, czy materiał został dodany.
3. Generujesz i pobierasz Audio Overview
Możesz poprosić AI o wygenerowanie Audio Overview dla notatnika. Serwer użyje wtedy narzędzia generate_audio. Jeśli chcesz zapisać gotowy plik, używasz narzędzia download_audio. Serwer pobiera najnowszy Audio Overview do wskazanego folderu.

Praca z wieloma kontami Google

Możesz używać osobnych profili Chrome dla różnych kont Google. Każde konto ma własne zapisane logowanie, profil przeglądarki i stan autoryzacji. Przy pierwszym uruchomieniu nowego konta musisz ponownie użyć setup_auth. Serwer nie przechowuje haseł w osobnym, szyfrowanym magazynie.
⚠️ Uwaga: Izolacja kont działa przez osobne katalogi profili Chrome. To nie jest szyfrowany magazyn danych logowania.

Profile narzędzi

Serwer może działać w różnych profilach narzędzi. Profil minimal daje podstawowe funkcje pytań i pracy z biblioteką. Profil standard dodaje między innymi logowanie, sesje i wyszukiwanie notatników. Profil full udostępnia wszystkie narzędzia opisane w dokumentacji.

Co warto zapamiętać?

  • Najpierw logujesz się do Google przez setup_auth.
  • Serwer zapisuje profil Chrome, aby kolejne uruchomienia były prostsze.
  • Pytania do notatników obsługuje narzędzie ask_question.
  • Źródła możesz dodawać jako URL albo tekst.
  • Audio Overview możesz wygenerować i pobrać jako plik.
  • Notatniki zapisujesz lokalnie w bibliotece serwera.

Instalacja NotebookLM MCP Server

NotebookLM MCP Server możesz uruchomić przez npx albo z lokalnej kopii kodu źródłowego. Najprostsza metoda to uruchomienie opublikowanej paczki. Jest to zalecana ścieżka dla osób, które chcą szybko zacząć pracę z serwerem.

Wymagania przed instalacją

  • Node.js 18 lub nowszy – potrzebujesz go do uruchomienia serwera.
  • Chrome – zalecana jest stabilna wersja przeglądarki Chrome.
  • Linux, macOS albo Windows – serwer działa na tych systemach.
  • WSL2 z WSLg – obsługiwane na Windows 11 i nowszych.
⚠️ Uwaga: WSL1 nie jest obsługiwany, ponieważ nie uruchomi Chromium. W takim przypadku potrzebujesz WSL2.

Instalacja przez npx

To najprostszy sposób uruchomienia NotebookLM MCP Server. 
npx notebooklm-mcp@latest
Komenda npx pobiera i uruchamia najnowszą wersję paczki. Dokumentacja wskazuje tę metodę jako zalecaną dla osób końcowych.

Instalacja z kodu źródłowego

Możesz też uruchomić serwer z lokalnej kopii repozytorium. 
git clone https://github.com/PleasePrompto/notebooklm-mcp
cd notebooklm-mcp
npm install
npm run build
node dist/index.js
Po instalacji zależności projekt buduje pliki w katalogu dist. Następnie uruchamiasz serwer przez plik dist/index.js.

Podłączenie do Claude Code

Jeśli używasz Claude Code, możesz dodać serwer jedną komendą. 
claude mcp add notebooklm -- npx notebooklm-mcp@latest
Jeśli pracujesz z lokalną kopią projektu, wskaż pełną ścieżkę do pliku dist/index.js. 
claude mcp add notebooklm -- node /absolute/path/to/notebooklm-mcp/dist/index.js

Konfiguracja ręczna w Claude Code

Możesz też dodać konfigurację ręcznie do pliku ~/.claude.json. 
{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["notebooklm-mcp@latest"]
    }
  }
}

Podłączenie do Cursor

W Cursor dodaj konfigurację do pliku ~/.cursor/mcp.json. 
{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["notebooklm-mcp@latest"]
    }
  }
}

Podłączenie do Codex CLI

W Codex CLI możesz dodać serwer tą komendą. 
codex mcp add notebooklm npx notebooklm-mcp@latest

Tryb HTTP dla narzędzi automatyzacji

Jeśli Twój klient MCP obsługuje tylko HTTP, uruchom serwer w trybie Streamable-HTTP. 
npx notebooklm-mcp@latest --transport http --port 3000
Możesz też udostępnić serwer na wszystkich interfejsach sieciowych. 
npx notebooklm-mcp@latest --transport http --port 3000 --host 0.0.0.0
⚠️ Uwaga: Używaj --host 0.0.0.0 tylko w zaufanej sieci.

Pierwsze logowanie do Google

Po uruchomieniu serwera musisz raz zalogować się do konta Google. Służy do tego narzędzie setup_auth. Logowanie otwiera widoczne okno Chrome. Po zalogowaniu serwer zapisuje profil przeglądarki i używa go przy kolejnych uruchomieniach.
ℹ️ Info: Przy pierwszym logowaniu masz do 10 minut na dokończenie procesu w oknie Chrome.

Uruchomienie na serwerze bez ekranu

Na serwerach Linux bez ekranu pierwsze logowanie nadal wymaga widocznego okna przeglądarki. Dokumentacja wskazuje uruchomienie jednorazowego logowania przez xvfb-run. 
xvfb-run -a npx notebooklm-mcp
Po zapisaniu profilu Chrome kolejne uruchomienia mogą działać w trybie headless.

Praca z wieloma kontami Google

Możesz uruchamiać osobne profile dla różnych kont Google. 
npx notebooklm-mcp@latest --account work
npx notebooklm-mcp@latest --account personal
Każde konto ma własny profil Chrome, własne cookies i osobny stan logowania.
💡 Wskazówka: Przy pierwszym uruchomieniu nowego konta ponownie użyj setup_auth.

Najważniejsze komendy

Cel Komenda
Uruchomienie najnowszej wersji npx notebooklm-mcp@latest
Tryb HTTP npx notebooklm-mcp@latest --transport http --port 3000
Claude Code claude mcp add notebooklm -- npx notebooklm-mcp@latest
Codex CLI codex mcp add notebooklm npx notebooklm-mcp@latest

FAQ – NotebookLM MCP Server

Do czego służy NotebookLM MCP Server?

NotebookLM MCP Server pozwala Twojemu asystentowi AI pracować z Google NotebookLM. Możesz zadawać pytania do notatnika, dodawać źródła, generować Audio Overview i pobierać gotowe nagrania.

Czy muszę logować się do konta Google za każdym razem?

Nie. Pierwsze logowanie wykonujesz przez narzędzie setup_auth w widocznym oknie Chrome. Po zalogowaniu serwer zapisuje profil przeglądarki i używa go przy kolejnych uruchomieniach.

Czy mogę używać kilku kont Google?

Tak. Możesz uruchomić osobne profile dla różnych kont, na przykład work i personal. Każde konto ma własny profil Chrome, osobne cookies i osobny stan logowania.

Jakie źródła mogę dodać do notatnika?

Możesz dodać źródło jako adres URL albo jako wklejony tekst. Służy do tego narzędzie add_source. Po dodaniu serwer zwraca liczbę źródeł przed i po zmianie.

Czy odpowiedzi mogą zawierać cytowania?

Tak. Narzędzie ask_question obsługuje różne formaty cytowań. Możesz wybrać odpowiedź bez źródeł, cytowania w tekście, przypisy albo dane w formacie JSON.

Kompatybilne między innmi z:

claude_logo_mcp
chatgpt_wtyczki_mcp
alice_logo_wtyczkiai

SZYBKA INSTALACJA

Code 
{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": [
        "-y",
        "notebooklm-mcp@latest"
      ]
    }
  }
}