🤖 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

Documento	Para quién
docs/AUTHENTICATION.md	Cómo obtener e inyectar cookies desde Chrome
docs/CONFIGURATION.md	Configurar el MCP en cada cliente AI
docs/AI_IMPLEMENTATION_GUIDE.md	Para agentes AI: guía completa de implementación paso a paso
docs/SKILL.md	Para agentes AI: instrucciones detalladas de orquestación y workflows

---

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)

Categoría	Herramienta	Descripción
Notebooks	notebook_list	Lista todos los notebooks
	notebook_create	Crea notebook vacío
	notebook_get	Detalles y fuentes de un notebook
	notebook_describe	Resumen IA del contenido
	notebook_rename	Renombrar notebook
	notebook_delete	Eliminar permanentemente
	notebook_query	Consulta IA basada en las fuentes
	chat_configure	Configurar estilo de respuesta
Fuentes	source_add	Agregar URL, texto, Drive o archivo local
	source_describe	Resumen IA de una fuente
	source_get_content	Texto crudo de la fuente
	source_delete	Eliminar fuente
	source_list_drive	Listar fuentes de Drive con estado
	source_sync_drive	Sincronizar fuentes desactualizadas
Notas	note	CRUD de notas internas (create/list/update/delete)
Investigación	research_start	Iniciar búsqueda web o Drive
	research_status	Poll de progreso de investigación
	research_import	Importar fuentes encontradas
Studio	studio_create	Generar audio/video/slides/infographic/report/flashcards/quiz/mind_map/data_table
	studio_status	Estado de generación y URLs
	studio_delete	Eliminar artefacto generado
	download_artifact	Descargar artefacto a archivo local
	export_artifact	Exportar a Google Docs o Sheets
Compartir	notebook_share_public	Habilitar link público
	notebook_share_invite	Invitar colaborador por email
	notebook_share_status	Ver configuración de compartido
Auth	refresh_auth	Recargar tokens desde disco
	save_auth_tokens	Guardar cookies manualmente

---

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