Comment connecter Claude et Cursor à Google NotebookLM directement depuis le terminal

Le service Google NotebookLM (récemment renommé Gemini Notebook) gère sans effort des quantités massives de documentation, de longs PDF et des vidéos YouTube. Il génère des réponses cohérentes avec des citations des sources et peut créer des podcasts audio amusants avec deux hôtes virtuels.

Un détail frustrant concernant ce service est qu'il lui manque toujours une API publique officielle.

Si vous souhaitez télécharger un lot de liens vers un notebook depuis le terminal, exporter des matériaux générés, ou faire rechercher à votre agent IA dans Cursor votre base de connaissances personnelle, vous êtes bloqué à cliquer dans le navigateur. Le développeur jacob-bd a résolu ce problème et a publié gemini-notebook-mcp-cli. Il fournit une interface en ligne de commande nlm et lance un serveur MCP local pour se connecter aux éditeurs de code.

Ce que cet utilitaire peut accomplir

Le dépôt combine deux outils : une CLI classique pour les scripts bash et un serveur MCP (Model Context Protocol).

Via une commande de terminal nlm, vous pouvez gérer des notebooks sans ouvrir un onglet de navigateur. Les opérations disponibles incluent la création de notes, le téléchargement de sources, l'interrogation de la base de données et l'exportation d'artefacts :

# Создаем блокнот под ресерч
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 partie la plus intéressante commence lors de la configuration de MCP. Le package peut s'enregistrer automatiquement dans les fichiers de configuration des outils populaires : Claude Code, Claude Desktop, Cursor, Gemini CLI, Windsurf et Cline.

Commande de configuration rapide :

nlm setup add cursor
nlm setup add claude-code

Après cela, vous pouvez écrire en texte brut dans le chat de l'assistant : « Crée un notebook sur les transactions distribuées, ajoute-y cette pull request et génère un bref résumé. » L'assistant appellera les fonctions nécessaires en arrière-plan.

Fonctionnalités cachées du studio

Au-delà des réponses textuelles régulières, l'outil débloque l'accès aux générateurs de contenu de Gemini Notebook. Via CLI et MCP, vous pouvez exécuter :

1. Création de podcasts (discussion approfondie d'un sujet par deux intervenants).
2. Génération de vidéos de présentation en différentes durées et styles visuels.
3. Assemblage de flashcards et de guides d'apprentissage.
4. Infographies et cartes mentales basées sur les sources téléchargées.
5. Création et édition de diapositives de présentation.

Un bonus appréciable : toutes les requêtes envoyées via la console ou l'éditeur de code sont sauvegardées dans l'historique de l'interface web Google. Vous pouvez commencer à interroger dans le terminal et continuer à lire les réponses le soir depuis votre téléphone via le navigateur.

Comment fonctionne l'autorisation en coulisses

Puisqu'il n'y a pas d'API officielle, le projet fonctionne via les endpoints internes de Google. Vous aurez besoin de cookies valides d'une session authentifiée.

Les développeurs du projet ont automatisé ce processus. Vous exécutez la commande :

nlm login

L'utilitaire ouvre un profil de navigateur séparé (Chrome, Brave, Arc, Edge, Chromium et Firefox sont supportés), vous vous connectez à votre compte Google, et le script intercepte les jetons nécessaires et les sauvegarde localement.

L'outil supporte le travail avec plusieurs profils via le flag --profile work ou --profile personal. Les jetons CSRF sont automatiquement rafraîchis quand les requêtes échouent, et les cookies eux-mêmes durent de deux à quatre semaines.

Une histoire honnête de création et support communautaire

L'auteur du projet admet ouvertement dans le README qu'il a écrit la première version sans expérience profonde en Python, en utilisant activement l'assistance IA.

Le code a résolu un besoin immédiat mais était loin d'être idéal. L'auteur ne s'en est pas caché et a directement demandé de l'aide à la communauté pour le refactoring et la revue de code.

L'open source a fonctionné comme prévu. Des dizaines de développeurs ont rejoint le projet. Ils ont ajouté du connection pooling, une gestion d'erreurs appropriée, le support WSL2, la synchronisation Google Drive, des opérations par lots, et un audit de sécurité qui empêche les identifiants de fuir dans les logs. Le résultat est un outil fiable avec près de 6000 étoiles sur GitHub.

Avertissements

Avant d'intégrer l'utilitaire dans vos pipelines, gardez à l'esprit plusieurs limitations.

Premièrement, utiliser une API non documentée comporte le risque de rupture. Google peut changer le format de requête ou la structure de réponse à tout moment, et les scripts cesseront de fonctionner jusqu'à ce qu'un correctif soit publié.

Deuxièmement, les comptes gratuits ont une limite d'environ 50 requêtes par jour. Si vous voulez traiter une centaines de documents via un script batch à la fois, vous atteindrez ce plafond.

Troisièmement, le serveur expose 43 outils MCP séparés. Ce nombre de fonctions remplit заметно le contexte dans Claude Code ou Cursor. Si vous ne travaillez pas avec des notebooks en ce moment, il est préférable de désactiver temporairement le serveur dans les paramètres ou de configurer des exports sélectifs uniquement des méthodes dont vous avez besoin.

Installation

Le moyen le plus simple d'installer l'utilitaire est via le gestionnaire de paquets uv :

uv tool install notebooklm-mcp-cli

Si vous utilisez Python standard, pipx ou pip régulier fonctionnera :

pipx install notebooklm-mcp-cli

L'exécution sans installation permanente via uvx est également disponible :

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

À qui cela sera utile

Le projet plaira à ceux qui utilisent déjà activement Gemini Notebook pour analyser de grands volumes de texte, de documentation technique ou de cours, mais qui sont fatigués de la routine du navigateur. L'utilitaire est parfait pour automatiser la collecte de matériel, créer des scripts d'exportation de résumés, et intégrer le contexte de Google Drive directement dans votre chat de travail avec un assistant IA.