# 🤖 NotebookLM MCP — Multi-Account Setup

[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
[![notebooklm-mcp-cli 0.2.7](https://img.shields.io/badge/notebooklm--mcp--cli-0.2.7-green.svg)](https://pypi.org/project/notebooklm-mcp-cli/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

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

```bash
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:
```bash
.venv/bin/nlm login --profile personal
```

#### B. Modo Manual (Legacy)
Obtén cookies desde Chrome (ver [docs/AUTHENTICATION.md](docs/AUTHENTICATION.md)):
```bash
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`):

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

### 4. Verificar

```bash
python verify_profile.py
```

---

## Documentación

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

---

## Uso desde el cliente AI

```python
# 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:**
```bash
python verify_profile.py
```

**Renovar cookies:**
```bash
# 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`](https://pypi.org/project/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`](https://pypi.org/project/notebooklm-mcp-cli/)
- Configuración multi-cuenta, scripts de autenticación y documentación: este repositorio

---

## Licencia

MIT — ver [LICENSE](LICENSE)