Hoe Claude en Cursor te verbinden met Google NotebookLM direct vanaf de terminal

De Google NotebookLM-service (onlangs hernoemd naar Gemini Notebook) verwerkt moeiteloos enorme hoeveelheden documentatie, lange PDF's en YouTube-video's. Het genereert coherente antwoorden met citaten naar bronnen en kan leuke audiopodcasts maken met twee virtuele hosts.

Een frustrerend detail aan de service is dat het nog steeds geen officiële publieke API heeft.

Als je een batch links naar een notebook wilt uploaden vanaf de terminal, gegenereerde materialen wilt exporteren, of wilt dat je AI-agent in Cursor door je persoonlijke kennisbank zoekt, zit je vast met klikken door de browser. Ontwikkelaar jacob-bd heeft dit probleem opgelost en gemini-notebook-mcp-cli uitgebracht. Het biedt een command-line interface nlm en draait een lokale MCP-server voor verbinding met code-editors.

Wat de tool kan doen

De repository combineert twee tools: een klassieke CLI voor bash-scripts en een MCP (Model Context Protocol) server.

Via een terminalcommando nlm kun je notebooks beheren zonder een browsertab te openen. Beschikbare bewerkingen zijn onder andere notities maken, bronnen uploaden, de database doorzoeken en artefacten exporteren:

# Создаем блокнот под ресерч
nlm notebook create "Архитектура проекта"

# Добавляем ссылки и документы
nlm source add <notebook-id> --url "https://habr.com/..."

# Запускаем генерацию аудиообзора
nlm audio create <notebook-id> --confirm

# Скачиваем все созданные материалы в папку
nlm download all <notebook-id> -d ./exports

Het interessantste deel begint bij het instellen van MCP. Het pakket kan zichzelf automatisch registreren in de configuratiebestanden van populaire tools: Claude Code, Claude Desktop, Cursor, Gemini CLI, Windsurf en Cline.

Snelle installatieopdracht:

nlm setup add cursor
nlm setup add claude-code

Daarna kun je in gewone tekst schrijven in de assistent-chat: "Maak een notebook over gedistribueerde transacties, voeg deze pull request daar toe en genereer een korte samenvatting." De assistent roept de benodigde functies op de achtergrond aan.

Verborgen studio-functies

Naast gewone tekstreacties ontgrendelt de tool de toegang tot de contentgenerators van Gemini Notebook. Via CLI en MCP kun je het volgende uitvoeren:

1. Podcast-creatie (diepgaande bespreking van een onderwerp door twee sprekers).
2. Video-overzichtgeneratie in verschillende lengtes en visuele stijlen.
3. Flashcard- en leergidsassemblage.
4. Infographics en mindmaps op basis van geüploade bronnen.
5. Presentatiedia's maken en bewerken.

Een leuk extraatje: alle verzoeken die via de console of code-editor worden verzonden, worden opgeslagen in de Google-webinterfacegeschiedenis. Je kunt beginnen met zoeken in de terminal en 's avonds vanaf je telefoon via de browser verder lezen.

Hoe autorisatie onder de motorkap werkt

Omdat er geen officiële API is, werkt het project via Google's interne eindpunten. Je hebt geldige cookies van een geauthenticeerde sessie nodig.

De projectontwikkelaars hebben dit proces geautomatiseerd. Je voert het commando uit:

nlm login

De tool opent een apart browserprofiel (Chrome, Brave, Arc, Edge, Chromium en Firefox worden ondersteund), je logt in op je Google-account en het script onderschept de benodigde tokens en slaat ze lokaal op.

De tool ondersteunt het werken met meerdere profielen via de --profile work of --profile personal vlag. CSRF-tokens worden automatisch vernieuwd wanneer verzoeken mislukken en de cookies zelf gaan twee tot vier weken mee.

Een eerlijk verhaal over creatie en community-ondersteuning

De auteur van het project geeft openlijk toe in de README dat ze de eerste versie schreven zonder diepe ervaring in Python, actief gebruik makend van AI-assistentie.

De code loste een directe behoefte op maar was verre van ideaal. De auteur deinsde er niet voor terug en vroeg de community rechtstreeks om hulp bij refactoring en codereview.

Open source werkte zoals bedoeld. Dozens ontwikkelaars sloten zich aan bij het project. Ze voegden connection pooling toe, correcte foutafhandeling, WSL2-ondersteuning, Google Drive-synchronisatie, batch-bewerkingen en een beveiligingsaudit die voorkomt dat inloggegevens in logs lekken. Het resultaat is een betrouwbare tool met bijna 6000 sterren op GitHub.

Valkuilen

Voordat je de tool in je pipelines integreert, houd rekening met verschillende beperkingen.

Ten eerste brengt het gebruik van een niet-gedocumenteerde API het risico van breuk met zich mee. Google kan het aanvraagformaat of de responsstructuur op elk moment wijzigen en de scripts stoppen met werken totdat een patch wordt uitgebracht.

Ten tweede hebben gratis accounts een limiet van ongeveer 50 verzoeken per dag. Als je honderd documenten tegelijk door een batch-script wilt halen, raak je dat plafond.

Ten derde stelt de server 43 afzonderlijke MCP-tools bloot. Dit aantal functies vult merkbaar het contextvenster in Claude Code of Cursor. Als je momenteel niet met notebooks werkt, is het beter om de server tijdelijk uit te schakelen in de instellingen of geconfigureerde selectieve exports van alleen de methoden die je nodig hebt.

Installatie

De gemakkelijkste manier om de tool te installeren is via de uv package manager:

uv tool install notebooklm-mcp-cli

Als je standaard Python gebruikt, werken pipx of gewone pip:

pipx install notebooklm-mcp-cli

Uitvoeren zonder permanente installatie via uvx is ook beschikbaar:

uvx --from notebooklm-mcp-cli nlm --help

Wie heeft hier baat bij

Het project zal aanspreken bij degenen die Gemini Notebook al actief gebruiken voor het analyseren van grote hoeveelheden tekst, technische documentatie of lezingen, maar de browserroutine beu zijn. De tool is geweldig voor het automatiseren van materiaalverzameling, het maken van samenvatting-export scripts en het integreren van context van Google Drive direct in je werkchat met een AI-assistent.