Notebooklm MCP Multiprofile

🤖 NotebookLM MCP — Multi-Account Setup

Configuración lista para usar de Google NotebookLM como servidor MCP, con soporte para múltiples cuentas de Google simultáneas.

Compatible con cualquier cliente AI que soporte MCP: Antigravity, Claude Desktop, Cline, Continue, y otros.

¿Qué hace esto?

Convierte NotebookLM en un conjunto de ~50 herramientas que tu IA puede usar directamente:

• 📚 Gestionar notebooks (crear, listar, renombrar, eliminar, consultar)
• 🔗 Agregar fuentes (URLs, archivos locales, Google Drive, texto)
• 🎙️ Generar contenido (podcasts, videos, slides, informes, flashcards, quizzes)
• 🔍 Investigación profunda automática (busca y agrega docenas de fuentes web)
• 📝 Notas internas en notebooks (memoria persistente para el agente)
• 🔄 Multi-cuenta: cada cuenta de Google corre como servidor MCP independiente

Instalación rápida

1. Clonar e Instalar

git clone https://github.com/rulords/notebooklm-mcp-multiprofile.git
cd notebooklm-mcp-multiprofile

# Windows
Double click en setup.bat
# O via Terminal: .\setup.bat

# macOS / Linux
bash setup.sh
# O via Terminal: ./setup.sh

# Instalación manual:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Configurar autenticación

Existen dos métodos:

A. Modo Elite (Recomendado para Agentes) 🚀

Usa el binario nativo para abrir un navegador y loguearte en segundos:

.venv/bin/nlm login --profile personal

B. Modo Manual (Legacy)

Obtén cookies desde Chrome (ver docs/AUTHENTICATION.md):

python inject_profile.py --profile personal --email tu@gmail.com

3. Registrar en tu cliente AI

Edita el archivo de configuración MCP de tu cliente (ver mcp_config.example.json):

{
  "mcpServers": {
    "notebooklm_personal": {
      "command": "/ruta/al/proyecto/.venv/Scripts/python.exe",
      "args": ["-m", "notebooklm_tools.mcp.server"],
      "env": { "NLM_PROFILE": "personal" }
    }
  }
}

4. Verificar

python verify_profile.py

Documentación

Uso desde el cliente AI

# Listar notebooks
mcp_notebooklm_personal_notebook_list(max_results=10)

# Crear notebook
mcp_notebooklm_work_notebook_create(title="Investigación Q1 2026")

# Agregar fuente URL
mcp_notebooklm_personal_source_add(
    notebook_id="...",
    source_type="url",
    url="https://ejemplo.com/articulo"
)

# Generar podcast
mcp_notebooklm_personal_studio_create(
    notebook_id="...",
    artifact_type="audio",
    confirm=True
)

# Investigación profunda
mcp_notebooklm_work_research_start(
    query="inteligencia artificial en salud 2025",
    mode="deep"
)

Mantenimiento

Las cookies de Google expiran cada 1-4 semanas. Síntomas de cookies expiradas:

• MCP devuelve RPC Error 16 o Authentication expired
• En Antigravity: el servidor no aparece en el panel MCP ("server not found")

Diagnóstico rápido:

python verify_profile.py

Renovar cookies:

# Obtener cookies frescas (ver docs/AUTHENTICATION.md)
python inject_profile.py --profile [nombre] --email [email]

# Recargar en el cliente AI:
mcp_notebooklm_[nombre]_refresh_auth()

Motor MCP: notebooklm-mcp-cli

Este proyecto usa el paquete notebooklm-mcp-cli (PyPI), versión 0.2.7.

⚠️ Versión importante: 0.2.7 es la que incluye el set completo de ~50 herramientas. Las versiones notebooklm-mcp 2.x son reescrituras incompletas con solo funciones básicas de chat. No actualizar sin verificar que el set completo esté disponible.

Herramientas disponibles (~50 en total)

Seguridad

• Los archivos *_cookies.txt están en .gitignore — nunca se suben a GitHub
• Los perfiles se guardan en ~/.notebooklm-mcp-cli/ (fuera del repo)
• mcp_config.json con tus rutas locales también está ignorado — usar mcp_config.example.json como plantilla

Créditos

• Motor MCP: notebooklm-mcp-cli
• Configuración multi-cuenta, scripts de autenticación y documentación: este repositorio

Licencia

MIT — ver LICENSE