Come connettere Claude e Cursor con Google NotebookLM direttamente dal terminale
Il servizio Google NotebookLM (recentemente rinominato in Gemini Notebook) gestisce con facilità enormi quantità di documentazione, PDF lunghi e video di YouTube. Genera risposte coerenti con citazioni delle fonti e può creare divertenti podcast audio con due host virtuali.
Un dettaglio frustrante del servizio è che ancora manca un'API pubblica ufficiale.
Se vuoi caricare un batch di link su un notebook dal terminale, esportare i materiali generati, o far cercare al tuo agente AI in Cursor attraverso la tua base di conoscenza personale, sei bloccato a cliccare attraverso il browser. Lo sviluppatore jacob-bd ha risolto questo problema e ha rilasciato gemini-notebook-mcp-cli. Fornisce un'interfaccia a riga di comando nlm e avvia un server MCP locale per connettersi agli editor di codice.
Cosa può fare l'utilità
Il repository combina due strumenti: una CLI classica per script bash e un server MCP (Model Context Protocol).
Attraverso un comando da terminale nlm, puoi gestire i notebook senza aprire una scheda del browser. Le operazioni disponibili includono la creazione di note, il caricamento di fonti, l'interrogazione del database e l'esportazione di artefatti:
# Создаем блокнот под ресерч
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
La parte più interessante inizia quando si imposta MCP. Il pacchetto può registrarsi automaticamente nei file di configurazione degli strumenti più diffusi: Claude Code, Claude Desktop, Cursor, Gemini CLI, Windsurf e Cline.
Comando di configurazione rapida:
nlm setup add cursor
nlm setup add claude-code
Dopo di che, puoi scrivere in testo normale nella chat dell'assistente: "Crea un notebook sulle transazioni distribuite, aggiungi qui questa pull request e genera un breve riepilogo." L'assistente chiamerà le funzioni necessarie dietro le quinte.
Funzionalità nascoste dello studio
Oltre alle normali risposte di testo, lo strumento sblocca l'accesso ai generatori di contenuto di Gemini Notebook. Attraverso CLI e MCP, puoi eseguire:
- Creazione di podcast (discussione approfondita di un argomento da parte di due relatori).
- Generazione di panoramiche video in varie lunghezze e stili visivi.
- Assemblaggio di flashcard e guide di studio.
- Infografiche e mappe mentali basate sulle fonti caricate.
- Creazione e modifica di slide per presentazioni.
Un bel bonus: tutte le richieste inviate attraverso la console o l'editor di codice vengono salvate nella cronologia dell'interfaccia web di Google. Puoi iniziare a interrogare dal terminale e continuare a leggere le risposte la sera dal telefono tramite il browser.
Come funziona l'autorizzazione sotto il cofano
Dato che non c'è un'API ufficiale, il progetto funziona attraverso gli endpoint interni di Google. Avrai bisogno di cookie validi da una sessione autenticata.
Gli sviluppatori del progetto hanno automatizzato questo processo. Esegui il comando:
nlm login
L'utilità apre un profilo browser separato (sono supportati Chrome, Brave, Arc, Edge, Chromium e Firefox), accedi al tuo account Google e lo script intercetta i token necessari e li salva localmente.
Lo strumento supporta il lavoro con più profili tramite il flag --profile work o --profile personal. I token CSRF vengono aggiornati automaticamente quando le richieste falliscono e i cookie stessi durano da due a quattro settimane.
Una storia onesta di creazione e supporto della community
L'autore del progetto ammette apertamente nel README che ha scritto la prima versione senza un'esperienza profonda in Python, usando attivamente l'assistenza AI.
Il codice risolveva un'esigenza immediata ma era lontano dall'essere ideale. L'autore non si è tirato indietro e ha chiesto direttamente aiuto alla community per il refactoring e la revisione del codice.
L'open source ha funzionato come previsto. Decine di sviluppatori si sono uniti al progetto. Hanno aggiunto connection pooling, gestione corretta degli errori, supporto WSL2, sincronizzazione con Google Drive, operazioni batch e un audit di sicurezza che impedisce alle credenziali di trapelare nei log. Il risultato è uno strumento affidabile con quasi 6000 stelle su GitHub.
Caveat
Prima di integrare l'utilità nelle tue pipeline, tieni presenti diverse limitazioni.
Prima di tutto, usare un'API non documentata comporta il rischio di rottura. Google può cambiare il formato della richiesta o la struttura della risposta in qualsiasi momento e gli script smetteranno di funzionare fino a quando non verrà rilasciata una patch.
In secondo luogo, gli account gratuiti hanno un limite di circa 50 richieste al giorno. Se vuoi elaborare cento documenti attraverso uno script batch tutto in una volta, raggiungerai quel tetto.
In terzo luogo, il server espone 43 strumenti MCP separati. Questo numero di funzioni riempie notevolmente la finestra di contesto in Claude Code o Cursor. Se non stai lavorando con i notebook in questo momento, è meglio disabilitare temporaneamente il server nelle impostazioni o configurare esportazioni selettive solo dei metodi che ti servono.
Installazione
Il modo più semplice per installare l'utilità è tramite il gestore di pacchetti uv:
uv tool install notebooklm-mcp-cli
Se stai usando Python standard, pipx o il normale pip funzioneranno:
pipx install notebooklm-mcp-cli
È disponibile anche l'esecuzione senza installazione permanente tramite uvx:
uvx --from notebooklm-mcp-cli nlm --help
A chi sarà utile
Il progetto piacerà a chi usa già attivamente Gemini Notebook per analizzare grandi volumi di testo, documentazione tecnica o lezioni, ma è stanco della routine del browser. L'utilità è ottima per automatizzare la raccolta di materiali, creare script di esportazione di riepilogo e integrare il contesto da Google Drive direttamente nella tua chat di lavoro con un assistente AI.
Progetti correlati