Notebooklm mcp server

NotebookLM MCP Server

Deja que tus agentes de IA chaten directamente con Google NotebookLM para obtener respuestas sin alucinaciones.

English • Español • Français • Português • Deutsch

Instalación • Autenticación • Inicio rápido • Claude Code • Documentación • Desarrollo

La Solución

El NotebookLM MCP Server lleva el poder de Google NotebookLM directamente a tu flujo de trabajo aumentado con IA. Construido nativamente en TypeScript usando el Model Context Protocol, permite a los agentes leer, buscar y gestionar tus cuadernos como si fueran archivos locales.

---

🚀 Instalación

1. Instalación Global (Recomendada)

Puedes instalar el servidor directamente desde NPM:

npm install -g notebooklm-mcp-server

[!NOTE] Auto-actualización: El servidor comprueba automáticamente nuevas versiones al iniciar. Si existe una actualización, se instalará y te pedirá que reinicies para asegurarte de tener siempre las últimas correcciones de Google.

2. Uso directo con NPX (Cero configuración)

Si no quieres instalarlo globalmente, puedes ejecutarlo directamente:

npx notebooklm-mcp-server auth   # To log in
npx notebooklm-mcp-server start  # To run the server

---

🔑 Autenticación

Antes de usar el servidor, debes vincularlo a tu cuenta de Google. Esta versión utiliza una sesión de navegador segura y persistente:

1. Ejecuta el comando de autenticación:

   npx notebooklm-mcp-server auth
   

2. Se abrirá una ventana del navegador. Inicia sesión con tu cuenta de Google.
3. Cierra el navegador una vez que veas tus cuadernos. Tu sesión ahora se guarda de forma segura localmente.

[!TIP] ¿Sesión expirada? Si tu agente recibe errores de autenticación, simplemente pídele que ejecute el comando npx notebooklm-mcp-server refresh_auth. Abrirá automáticamente el navegador para que renueves la sesión sin salir del chat.

---

⚡ Inicio rápido

🤖 Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

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

💻 Visual Studio Code

Dado que VS Code aún no soporta MCP de forma nativa, debes usar una extensión:

Opción A: Usando Cline (Recomendada)

1. Abre Configuración de Cline en VS Code.
2. Desplázate hasta la sección Servidores MCP.
3. Haz clic en Añadir nuevo servidor MCP.
4. Usa la siguiente configuración:
   • Nombre: notebooklm
   • Comando: npx -y notebooklm-mcp-server start

Opción B: Usando MCP Client

1. Instala la extensión desde el Marketplace.
2. Abre tu settings.json de VS Code.
3. Añade el servidor bajo mcp.servers:

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

🌌 Antigravity

Antigravity soporta MCP de forma nativa. Puedes añadir el servidor editando tu archivo de configuración global:

1. Localiza tu mcp.json:

   • Windows: %APPDATA%\antigravity\mcp.json
   • macOS: ~/Library/Application Support/antigravity/mcp.json
   • Linux: ~/.config/antigravity/mcp.json

2. Añade el servidor al objeto mcpServers:

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

3. Reinicia Antigravity: Las nuevas herramientas aparecerán en tu barra lateral al instante.

---

💎 Gemini CLI

Ejecuta el siguiente comando en tu terminal para añadir la habilidad notebooklm:

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

---

🤖 Habilidad de Claude Code

Añádela al instante a Claude Code:

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

---

📖 Documentación

Las siguientes herramientas están disponibles a través de este servidor MCP:

📒 Gestión de cuadernos

Herramienta	Descripción
notebook_list	Lista todos los cuadernos de tu cuenta.
notebook_create	Crea un nuevo cuaderno con un título.
notebook_rename	Renombra un cuaderno existente.
notebook_delete	Elimina un cuaderno (Advertencia: Destructivo).

🖇️ Gestión de fuentes

Herramienta	Descripción
notebook_add_url	Añade un sitio web o video de YouTube como fuente.
notebook_add_text	Añade contenido de texto personalizado como fuente.
notebook_add_local_file	Sube un archivo local PDF, Markdown o Texto.
notebook_add_drive	Añade un archivo de Google Drive (Docs, Slides, etc.).
source_delete	Elimina una fuente de un cuaderno.
source_sync	Sincroniza una fuente de Drive para obtener la última versión.

🔍 Investigación y consulta

Herramienta	Descripción
notebook_query	Hace una pregunta fundamentada a un cuaderno específico.
research_start	Inicia una tarea de investigación web/drive.
research_poll	Consulta el estado y los resultados de la investigación.
research_import	Importa los resultados de la investigación como fuentes permanentes.

🎨 Estudio y generación

Herramienta	Descripción
audio_overview_create	Genera una vista general de audio (podcast).
studio_poll	Comprueba el estado de los artefactos de audio/video generados.
mind_map_generate	Genera un JSON de mapa mental a partir de fuentes.

⚙️ Sistema

Herramienta	Descripción
refresh_auth	Interactivo: Abre un navegador para renovar tu sesión de Google. Úsalo si las herramientas empiezan a fallar.

---

🛠️ Desarrollo

Para contribuir o compilar desde el código fuente:

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

🌐 Localización

Este proyecto está disponible en varios idiomas:

• English (Fuente)
• Español
• Français
• Português
• Deutsch

Si actualizas el README.md en inglés, asegúrate de que las traducciones se actualicen en consecuencia para mantener la documentación sincronizada.

📄 Licencia

Licencia MIT. Desarrollado con ❤️ por moodRobotics.