hucompany

Funciones principales

Related MCP server: NotebookLM MCP Server

Aviso importante

Este MCP utiliza las siguientes API internas:

• No están documentadas y pueden cambiar sin previo aviso.

• Requieren la extracción de cookies desde el navegador.

Úselo solo con fines personales/experimentales.

Instalación

Puede instalar notebooklm-mcp-server desde PyPI utilizando su administrador de paquetes de Python preferido (uv, pip, pipx, etc.).

También se admite la instalación directa desde el código fuente.

Actualización

Actualice a la última versión utilizando el comando de actualización de su administrador de paquetes.

Después de la actualización, debe reiniciar su herramienta de IA para renovar la conexión:

• Claude Code: reinicie la aplicación o use el comando de reconexión

• Cursor: reinicie la aplicación

• Gemini CLI: reinicie la sesión de CLI

Desinstalación

Para eliminar el MCP por completo, use el comando de desinstalación de su administrador de paquetes. Opcionalmente, también puede eliminarlo de los tokens de autenticación en caché o de los archivos de configuración de su herramienta de IA.

Autenticación

Antes de usar el MCP, se requiere autenticación de NotebookLM.

Se recomienda el modo automático. Al ejecutar un perfil de Chrome dedicado e iniciar sesión en Google, las cookies se extraen automáticamente. La información de inicio de sesión se guarda para futuras renovaciones de autenticación.

Si el modo automático no funciona, puede extraer y guardar manualmente las cookies desde las herramientas de desarrollador de Chrome mediante el modo de archivo.

Después de una autenticación exitosa, agregue el MCP a su herramienta de IA y reiníciela.

Para obtener más detalles y solucionar problemas, consulte **docs/AUTHENTICATION.md**.

Configuración del MCP

⚠️ Advertencia sobre la ventana de contexto: Este MCP proporciona 31 herramientas, por lo que puede ocupar mucho espacio en la ventana de contexto. Cuando no esté usando NotebookLM activamente, se recomienda desactivar el MCP para liberar contexto para otras tareas.

Opciones de CLI

Puede configurar el servidor mediante argumentos de línea de comandos. Permiten ajustar el protocolo de transporte (stdio, http, sse), el puerto, el host, el modo de depuración, el tiempo de espera de consulta, etc.

Variables de entorno

También se puede configurar mediante variables de entorno. (NOTEBOOKLM_MCP_TRANSPORT, NOTEBOOKLM_MCP_PORT, etc.)

Conexión con herramientas de IA (Claude Code, Gemini CLI, IDE, etc.)

Herramientas como Claude Code o Gemini CLI permiten agregar fácilmente el servidor MCP mediante comandos integrados.

Para herramientas que usan archivos de configuración JSON, como Cursor, VS Code y Claude Desktop, debe localizar la ruta del notebooklm-mcp instalado y agregarlo a la entrada mcpServers del archivo de configuración.

Ejemplos de uso

Puede conversar en lenguaje natural con herramientas de IA como Claude Code, Cursor o Gemini CLI y utilizarlas de las siguientes maneras.

Investigación y exploración

• "Muéstrame la lista de todos mis cuadernos de NotebookLM"

• "Crea un nuevo cuaderno llamado 'Investigación de estrategias de IA'"

• "Inicia una investigación web sobre 'métricas de ROI de IA empresarial' y muéstrame las fuentes encontradas"

• "Realiza una investigación en profundidad sobre 'tendencias del mercado en la nube' e importa las 10 mejores fuentes"

• "Busca en mi Google Drive documentos relacionados con 'hoja de ruta de producto' y crea un cuaderno"

Adición de contenido

• "Agrega esta URL a mi cuaderno: https://example.com/article"

• "Agrega este video de YouTube sobre Kubernetes a mi cuaderno"

• "Agrega mis notas de reunión como fuente de texto a este cuaderno"

• "Importa este documento de Google a mi cuaderno de investigación"

Análisis basado en IA

• "¿Cuáles son los hallazgos clave de este cuaderno?"

• "Resume los argumentos principales de todas estas fuentes"

• "¿Qué dice esta fuente sobre las mejores prácticas de seguridad?"

• "Haz un resumen de IA de qué trata este cuaderno"

• "Cambia la configuración del chat al estilo de guía de estudio y haz que las respuestas sean más largas"

Generación de contenido

• "Convierte este cuaderno en una descripción general de audio en formato pódcast con análisis en profundidad"

• "Genera un video de descripción general con estilo visual clásico"

• "Crea un documento informativo a partir de estas fuentes"

• "Crea tarjetas de estudio con dificultad media"

• "Genera una infografía en orientación horizontal"

• "Dibuja un mapa mental con mis fuentes de investigación"

• "Crea una presentación de diapositivas a partir de este cuaderno"

Gestión inteligente

• "Revisa las fuentes de Google Drive que necesitan actualización y sincronízalas"

• "Muéstrame todas las fuentes de este cuaderno y si están actualizadas"

• "Elimina esta fuente del cuaderno"

• "Verifica el estado de generación de mi resumen de audio"

Ciclo de vida de la autenticación

• Cookies: duran aproximadamente 2~4 semanas (se renuevan automáticamente mediante Chrome headless si hay un perfil guardado)

• Token CSRF: dura unos minutos (se renueva automáticamente cuando falla una solicitud)

• ID de sesión: se mantiene por sesión de MCP (se extrae automáticamente al iniciar el MCP)

v0.1.9+: el servidor gestiona automáticamente la expiración de los tokens.

1. Renueva el token CSRF inmediatamente cuando expira

2. Vuelve a cargar las cookies desde el disco si se actualizaron externamente

3. Ejecuta la autenticación con Chrome headless si hay un perfil de inicio de sesión guardado

Si la renovación automática falla (cuando el inicio de sesión de Google ha expirado por completo), debe volver a ejecutar la herramienta de autenticación.

Solución de problemas

Si la actualización no se realiza correctamente

Es posible que la última versión no se instale debido a problemas de caché o restricciones de versión del administrador de paquetes. En ese caso, puede resolverlo utilizando la opción de reinstalación forzada.

Si Chrome DevTools MCP no funciona (Cursor/Gemini CLI)

Si Chrome DevTools MCP aparece como "sin herramientas" o no se inicia, puede deberse a un error conocido de npx. En este caso, cambiar la configuración para que se ejecute con pnpm podría resolverlo.

Limitaciones

• Límite de velocidad: el nivel gratuito está limitado a aproximadamente 50 consultas por día.

• Sin soporte oficial: la API puede cambiar sin previo aviso.

• Expiración de cookies: es posible que deba volver a extraer las cookies cada pocas semanas.

Contribuciones

Consulte CLAUDE.md para conocer la documentación de la API y cómo agregar nuevas funciones.

Licencia

MIT License