skills

NotebookLM Sync - Skill para Claude Code

Integración entre Claude Code y Google NotebookLM para usar un notebook como sistema de memoria persistente por proyecto.

Características

✅ Consulta de notebooks - Haz preguntas a tus notebooks de NotebookLM desde Claude Code ✅ Síntesis automática - Genera resúmenes de sesiones para guardar en NotebookLM ✅ Gestión de proyectos - Mapea proyectos locales con sus notebooks ✅ Navegador automático - Abre directamente el notebook del proyecto actual

Instalación

1. Instalar la skill de consulta (notebooklm-skill)

git clone https://github.com/PleasePrompto/notebooklm-skill ~/.claude/skills/notebooklm
cd ~/.claude/skills/notebooklm
python -m venv .venv
source .venv/Scripts/activate  # En Windows: .venv\Scripts\activate
pip install patchright==1.55.2 python-dotenv==1.0.0
python -m patchright install chrome

2. Autenticar con Google

Ejecuta desde la carpeta del proyecto:

cd ~/.claude/skills/notebooklm-sync
python simple_auth.py

Esto abrirá tu navegador. Haz login en tu cuenta de Google y presiona ENTER en la consola cuando veas NotebookLM.

3. Crear tu primer notebook

1. Ve a https://notebooklm.google.com
2. Crea un nuevo notebook (ej: "Mi Proyecto PR")
3. Sube documentos o archivos que quieras que NotebookLM analice

4. Registrar el notebook

Copia la URL del notebook (estará en la barra de direcciones como https://notebooklm.google.com/notebook/...)

Desde tu carpeta de proyecto, ejecuta:

python ~/.claude/skills/notebooklm-sync/register_notebook.py "https://notebooklm.google.com/notebook/..."

O simplemente edita ~/.claude/memory/projects.json:

{
  "tu-proyecto": {
    "url": "https://notebooklm.google.com/notebook/...",
    "created_at": "2026-04-14"
  }
}

Uso

Generar síntesis de sesión

/notebooklm-sync

Esto genera un archivo markdown con la síntesis de tu sesión y abre el notebook en el navegador. Luego tú subes manualmente el archivo al notebook.

Hacer preguntas al notebook

¿Cuáles fueron las decisiones técnicas importantes?

Claude Code consultará tu notebook y dará respuestas basadas en los documentos que subiste.

Registrar nuevo proyecto

python ~/.claude/skills/notebooklm-sync/register_notebook.py "https://notebooklm.google.com/notebook/..."

Flujo de trabajo recomendado

1. Al comenzar un proyecto:

   • Crea un notebook en NotebookLM
   • Sube documentos, especificaciones, notas de diseño
   • Registra el notebook con register_notebook.py

2. Durante el desarrollo:

   • Claude Code puede consultar el notebook cuando lo necesita
   • Ejecuta /notebooklm-sync al final de sesiones importantes

3. Manualmente en NotebookLM:

   • Sube los archivos .md generados por /notebooklm-sync
   • Los documentos ayudan a NotebookLM a entender mejor tu proyecto

Limitaciones actuales

• Los uploads al notebook deben ser manuales - NotebookLM no tiene API oficial para subir archivos
• Las consultas requieren autenticación previa - Debes hacer login una sola vez con simple_auth.py
• Máximo 50 consultas/día - En cuentas gratuitas de NotebookLM
• Solo funciona en Claude Code local - No en la web UI de claude.ai

Configuración avanzada

Archivos clave

~/.claude/skills/notebooklm-sync/
  ├── skill.md                 # Definición del skill
  ├── synthesize.py            # Genera síntesis
  ├── open_notebook.py         # Abre notebook en navegador
  ├── register_notebook.py     # Registra nuevos notebooks
  └── simple_auth.py           # Autentica con Google

~/.claude/memory-notebooklm/
  ├── projects.json            # Mapa proyectos → notebooks
  └── syntheses/               # Síntesis generadas por sesión
      └── <proyecto>/
          └── 2026-04-14.md

Editar projects.json

El archivo se encuentra en: ~/.claude/memory-notebooklm/projects.json

{
  "nombre-proyecto": {
    "url": "https://notebooklm.google.com/notebook/...",
    "created_at": "2026-04-14T00:00:00",
    "last_synced": "2026-04-14T15:30:00"
  }
}

Solución de problemas

"Error de autenticación"

cd ~/.claude/skills/notebooklm-sync
python simple_auth.py

"No se encuentra el notebook registrado"

1. Verifica que estés en el directorio del proyecto correcto
2. Revisa que projects.json tenga la entrada correcta
3. La clave debe coincidir con basename del directorio

"El notebook no responde"

1. Asegúrate de haber subido documentos al notebook en NotebookLM
2. NotebookLM necesita archivos para analizar
3. Espera 30 segundos después de subir un archivo

Referencias

• NotebookLM Official
• notebooklm-skill on GitHub
• Claude Code Memory System

Roadmap

• Auto-upload de síntesis a NotebookLM (cuando tenga API)
• Sincronización programada
• Integración con git para resúmenes automáticos de commits
• Chat persistente con el notebook
• Exportar síntesis a PDF/DOCX