Notebooklm mcp server

---

💡 ¿Qué es esto?

Gemini Notebook de Google (renombrado desde NotebookLM en julio de 2026) es el mejor motor de respuestas fundamentadas del mercado: solo responde a partir de las fuentes que le proporcionas, con citas. Este servidor MCP pone ese poder en manos de tus agentes de IA — Claude, Gemini, Antigravity, Cursor y cualquier otro cliente MCP — para que puedan crear cuadernos, ejecutar Deep Research, generar podcasts, videos, cuestionarios, tarjetas de memoria, informes y mapas mentales, tomar notas y compartir los resultados con tu equipo. Todo programáticamente, con cero alucinaciones.

[!NOTE] NotebookLM ahora es Gemini Notebook. Google renombró el producto el 16 de julio de 2026 (ver notebook.google). Mismo producto, mismos cuadernos, misma superficie de API — este servidor sigue funcionando sin cambios, y el paquete npm conserva su nombre notebooklm-mcp-server.

🚀 Instalación

Opción 1 — Instalación global (recomendada)

npm install -g notebooklm-mcp-server

[!NOTE] El servidor verifica actualizaciones al iniciar y se mantiene actualizado automáticamente.

Opción 2 — Instalación sin descarga con NPX

npx -y notebooklm-mcp-server auth   # authenticate
npx -y notebooklm-mcp-server start  # run the server

🔑 Autenticación

1. Ejecuta el inicio de sesión interactivo (abre una ventana de Chromium):

npx notebooklm-mcp-server auth

2. Inicia sesión con tu cuenta de Google. Cuando aparezca la lista de cuadernos, las cookies de sesión (incluido el token rotatorio __Secure-1PSIDTS de Google) se capturan y se guardan en ~/.notebooklm-mcp/auth.json.

3. Listo — el servidor carga la sesión automáticamente y refresca el token rotatorio por sí mismo.

[!TIP] Si la sesión expira alguna vez, ejecuta npx notebooklm-mcp-server auth nuevamente en una terminal y luego llama a la herramienta MCP refresh_auth (o simplemente reinicia tu cliente) para recoger las nuevas cookies sin reconfigurar nada.

⚡ Conecta tu cliente de IA

🤖 Claude Code

claude mcp add notebooklm -- npx -y notebooklm-mcp-server start

💬 Claude Desktop

Añade a claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

🌌 Antigravity CLI

La CLI de Antigravity gestiona los servidores MCP a través de un archivo de configuración JSON:

• Global: ~/.gemini/config/mcp_config.json
• Por espacio de trabajo: .agents/mcp_config.json en tu proyecto

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

Luego escribe /mcp en el panel de indicaciones de Antigravity para abrir el MCP Manager: verifica el anillo de estado de conexión, recarga la configuración o inspecciona los registros — sin necesidad de reiniciar. Tus agentes ahora pueden citar fuentes reales en cada misión.

🖥️ Antigravity IDE

El IDE lee los mismos archivos de configuración que la CLI (~/.gemini/config/mcp_config.json o .agents/mcp_config.json). Alternativamente, abre el panel MCP Store, elige Añadir servidor personalizado y pega el mismo fragmento JSON. Recarga la lista de servidores y las herramientas de NotebookLM aparecerán en la caja de herramientas del agente.

💎 Gemini CLI

gemini mcp add notebooklm --scope user -- npx -y notebooklm-mcp-server start

⌨️ Cursor

Añade a .cursor/mcp.json en tu proyecto (o ~/.cursor/mcp.json globalmente):

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

🏄 Windsurf

Añade el mismo bloque mcpServers a ~/.codeium/windsurf/mcp_config.json.

🧩 VS Code (Cline)

En Cline: MCP Servers → Configure y añade el mismo bloque mcpServers mostrado arriba.

📖 Referencia de herramientas

47 herramientas, agrupadas por lo que hacen. Las firmas completas de parámetros están en docs/TOOLS.md.

📒 Cuadernos

Herramienta	Descripción
notebook_list	Lista todos los cuadernos con fuentes y metadatos
notebook_create	Crea un nuevo cuaderno
notebook_get	Obtiene los detalles de un cuaderno y sus IDs de fuentes
notebook_rename	Renombra un cuaderno
notebook_delete	Elimina un cuaderno (requiere confirm)
notebook_summarize	Guía de IA del cuaderno: resumen + preguntas sugeridas
prompts_suggest	Indicaciones sugeridas por IA para preguntar sobre las fuentes

🔗 Compartir

Herramienta	Descripción
notebook_share	Alterna el enlace público y/o gestiona colaboradores por correo electrónico
notebook_share_status	Lee la configuración de uso compartido actual

🖇️ Fuentes

Herramienta	Descripción
notebook_add_url	Añade un sitio web o video de YouTube como fuente
notebook_add_text	Añade texto pegado como fuente
notebook_add_drive	Añade un documento de Google Drive como fuente
notebook_add_local_file	Sube un archivo local PDF / TXT / Markdown
source_get_guide	Guía de IA para una fuente: resumen + temas clave
source_rename	Renombra una fuente
source_check_freshness	Verifica si una fuente URL/Drive tiene contenido más reciente
source_sync	Re-sincroniza una fuente de Drive con el contenido más reciente
source_delete	Elimina una fuente (requiere confirm)

💬 Chat

Herramienta	Descripción
notebook_query	Haz preguntas sobre las fuentes, con citas
chat_history_get	Lee los turnos de preguntas y respuestas de la conversación más reciente
chat_history_delete	Borra el historial del chat (requiere confirm)
chat_configure	Establece la personalidad del chat (predeterminada / guía de aprendizaje / personalizada) y la longitud de la respuesta

🔍 Investigación

Herramienta	Descripción
research_start	Lanza investigación web o de Drive (rápida ≈30s / profunda ≈5min)
research_poll	Verifica el progreso de la investigación y las fuentes descubiertas
research_import	Importa las fuentes descubiertas al cuaderno

🎨 Estudio

Herramienta	Descripción
audio_overview_create	Resumen de audio estilo podcast (formatos: inmersión profunda, breve, crítica, debate)
video_overview_create	Resumen de video (9 estilos visuales, desde pizarra hasta anime)
report_create	Informe escrito a partir de las fuentes
flashcards_create	Tarjetas de memoria (opciones de cantidad y dificultad)
quiz_create	Cuestionario interactivo (opciones de cantidad y dificultad)
infographic_create	Infografía (horizontal / vertical / cuadrado)
slide_deck_create	Presentación de diapositivas
data_table_create	Tabla de datos estructurada
studio_poll	Verifica el estado de generación de todos los artefactos
studio_delete	Elimina un artefacto de estudio

📦 Artefactos

Herramienta	Descripción
artifact_content_get	Obtiene el contenido generado (HTML de cuestionario/tarjetas, JSON de mapa mental)
artifact_rename	Renombra un artefacto
artifact_export	Exporta un artefacto a Google Drive (Docs o Sheets)

📝 Notas y mapas mentales

Herramienta	Descripción
note_create	Crea una nota
note_list	Lista todas las notas
note_update	Actualiza el contenido/título de una nota
note_delete	Elimina una nota (requiere confirm)
mind_map_generate	Genera un JSON de mapa mental a partir de las fuentes
mind_map_save	Guarda un mapa mental en el cuaderno
mind_map_list	Lista los mapas mentales guardados
mind_map_delete	Elimina un mapa mental

⚙️ Sistema

Herramienta	Descripción
refresh_auth	Recarga las cookies de sesión desde el disco después de volver a ejecutar auth

🧪 Recetas

Indicaciones reales que puedes pegar en cualquier agente conectado — elige las herramientas adecuadas por sí mismo.

🎙️ De la pregunta de investigación al podcast

"Investiga lo último sobre baterías de estado sólido con investigación profunda, crea un cuaderno llamado 'Solid State 2026' con las mejores fuentes y genera un resumen de audio breve en inglés. Dame el enlace cuando esté listo."

El agente encadena notebook_create → research_start(mode: deep) → research_poll → research_import → audio_overview_create(format: brief) → studio_poll, y devuelve la URL del cuaderno con el podcast terminado.

🎓 Kit de estudio a partir de tus PDFs

"Toma los tres PDFs en ./lectures, ponlos en un cuaderno nuevo y hazme un cuestionario difícil más tarjetas de memoria sobre los conceptos clave. Muéstrame las preguntas del cuestionario aquí."

El agente ejecuta notebook_add_local_file por PDF, luego quiz_create(difficulty: hard) + flashcards_create, consulta con studio_poll y extrae las preguntas con artifact_content_get.

👥 Informe de equipo, compartido

"Crea un cuaderno informativo a partir de estos cinco enlaces sobre nuestro competidor, escribe un informe, expórtalo a Google Docs y comparte el cuaderno con ana@example.com como visor."

El agente encadena notebook_add_url ×5 → report_create → studio_poll → artifact_export(format: docs) → notebook_share(user_email, user_role: viewer) — y tu compañero encuentra el cuaderno y el Doc esperando.

🛠️ Solución de problemas

Síntoma	Solución
auth advierte que la API rechazó tus cookies justo después de iniciar sesión	Tu cuenta de Google aplica Device Bound Session Credentials (DBSC) — activado por defecto para Workspace y la mayoría de cuentas personales. DBSC vincula la sesión a una clave del dispositivo, por lo que las cookies exportadas del navegador son rechazadas por la API. Los clientes de extracción de cookies no pueden evitar esto; usa una cuenta de Google sin aplicación de DBSC.
Authentication expired justo después de iniciar sesión	Actualiza a ≥ 3.0.8 — las versiones anteriores omitían el token rotatorio __Secure-1PSIDTS de Google. El servidor ahora lo captura y lo actualiza automáticamente.
Authentication failed después de semanas de uso	Las sesiones de Google eventualmente expiran. Ejecuta npx notebooklm-mcp-server auth y luego llama a la herramienta refresh_auth.
La generación de Studio se queda atascada en pending	Las fuentes largas tardan un tiempo — sigue consultando studio_poll; el audio/video puede tardar varios minutos.
Errores RPC después de una actualización de Google	Google ocasionalmente rota las etiquetas internas de compilación. Actualiza el paquete; si persiste, abre un issue.

🧑‍💻 Desarrollo

git clone https://github.com/moodRobotics/notebooklm-mcp-server.git
cd notebooklm-mcp-server
npm install
npm run build
npm run typecheck

Las notas de arquitectura están en docs/ARCHITECTURE.md, la hoja de ruta en docs/ROADMAP.md.

🌐 Localización

Este README está disponible en English, Español, Français, Português y Deutsch. Si editas uno, por favor mantén los demás sincronizados (npm run docs:check).

📄 Licencia

MIT — Desarrollado con ❤️ por moodRobotics.

[!IMPORTANT] Este es un proyecto comunitario no oficial. No está afiliado ni respaldado por Google. Se basa en APIs internas de ingeniería inversa que pueden cambiar sin previo aviso; úsalo con una cuenta de Google con la que te sientas cómodo automatizando.