Aller au contenu
roomi fields

Outils pour travailler avec des agents IA

notebooklm-mcp

Piloter NotebookLM de Google depuis un agent, par un serveur MCP, ou depuis n'importe quel outil qui parle HTTP.

actif version v4.4.0, 24 octobre 2026 dernière modification 24 octobre 2026 licence MIT

Code source Site

Le projet part du serveur MCP NotebookLM de Gérôme Dexheimer (Please Prompto!, licence MIT), auquel j’ai ajouté une API REST, la génération du Studio et la rotation de comptes, pour les besoins d’une revue de littérature doctorale menée par lots de plus de 1 000 questions. Sa limite principale : il passe par les appels internes de l’application web de NotebookLM, que Google ne documente pas et peut changer sans préavis ; le projet n’est pas affilié à Google, et les quotas de NotebookLM s’appliquent.

Pas de démo jouable : il faut un compte Google et un carnet NotebookLM.

Un service sans API, rendu appelable

NotebookLM répond à partir des sources déposées dans un carnet, et chaque réponse renvoie aux passages qui la fondent. Google n’en propose pas d’API publique. Le projet emprunte donc deux voies : les appels batchexecute qu’utilise l’application web elle-même, et un navigateur automatisé (Playwright) en secours quand ces appels changent.

Une citation rend la vérification possible : on va lire le passage. Elle ne garantit pas que la réponse est juste ; la relecture reste à faire.

Depuis juillet 2026, Google nomme le produit « Gemini Notebook ». C’est le même service ; le projet garde son nom.

Commencer

Dans Claude Code, par le catalogue roomi-fields/claude-plugins (Node 18 ou plus récent) :

/plugin marketplace add roomi-fields/claude-plugins
/plugin install notebooklm@roomi-fields

Puis, une fois, la connexion à Google, dans un terminal ; une fenêtre de Chrome s’ouvre :

npx -y -p @roomi-fields/notebooklm-mcp notebooklm-mcp-setup-auth

Pour l’API REST (n8n, Zapier, Make, curl) :

git clone https://github.com/roomi-fields/notebooklm-mcp.git
cd notebooklm-mcp
npm install && npm run build
npm run setup-auth
npm run start:http
curl -X POST http://localhost:3000/ask \
  -H 'Content-Type: application/json' \
  -d '{"question": "Summarize chapter 3", "notebook_id": "your-id", "source_format": "json"}'

Une image Docker existe aussi, pour un serveur ou un NAS.

Ce qu’il fait

  • Poser une question et recevoir la réponse avec ses citations, en cinq formats : aucune, en ligne, notes, JSON, développée avec l’extrait cité.
  • Générer les contenus du Studio : résumé audio, vidéo, infographie, rapport, présentation, tableau, fiches, quiz, carte mentale ; dans l’une des 81 langues acceptées.
  • Télécharger l’audio (WAV), la vidéo (MP4), l’infographie (PNG) ; supprimer un contenu généré (content_delete).
  • Gérer les sources : ajouter un PDF, un DOCX, une adresse, une vidéo YouTube, un document Drive ; lire le texte exact que NotebookLM a indexé (source_read).
  • Enchaîner les lots : plusieurs comptes en rotation quand un quota quotidien est atteint, reconnexion automatique, reprise d’un lot interrompu.
  • Garder les réponses : vault_batch les écrit sur disque, en Markdown et en JSON selon un schéma publié, lisibles ensuite par RTFM.

L’API REST compte 33 points d’accès, décrits en OpenAPI 3.1.

Où il en est

L’intégration continue passe. La modification des notes n’est pas encore faite. Utilisez un compte Google dédié à l’automatisation : Google peut repérer un usage automatisé. Les nouveautés sont dans le journal des versions du dépôt.

Dépôt · Documentation · NotebookLM · RTFM

Merci à Gérôme Dexheimer (@PleasePrompto) pour le projet d’origine, et à Khizar Jamshaid Iqbal, Kazik Pietka, Rui Ruiberriz, @he0xwhale, @eminsnow et Julien Cantoni pour leurs correctifs et leurs ajouts.

Fabrication. Claude Code (Claude Opus 5.5), à partir du dépôt, de son README et de ses notes de version. Méthode

Tickets ouverts