Estado del servidor y de la sesión con NotebookLM (modo, caché, autenticación).

Lista los notebooks de la cuenta (id, título, nº de fuentes, fechas).

Metadatos de un notebook, su resumen generado y temas sugeridos.

Lista las fuentes de un notebook con tipo, estado, URL y nº de palabras.

Lee una fuente en Markdown, paginada. Para documentos largos prefiere get_source_outline + read_source_section.

Índice de encabezados (nivel, título, línea, posición) de una fuente en Markdown.

Lee solo una sección (hasta el siguiente encabezado del mismo nivel o superior).

Resumen y palabras clave que NotebookLM genera para una fuente.

Búsqueda semántica de NotebookLM: fragmentos más relevantes ordenados por relevancia.

Búsqueda léxica BM25 local (sin cuota) en un notebook o en todas a la vez.

Sin notebook_id barre todas las notebooks (o notebook_ids) y etiqueta cada resultado con su notebook de origen: sirve para saber en cuál documentaste algo sin recorrerlas una por una. notebooks_scanned_ids dice cuáles se recorrieron de verdad (con max_notebooks puede que la que te interesa se quedara fuera). Una notebook con problemas no aborta el barrido (notebook_errors con ref).

Busca un texto o regex (como grep) en la caché: en un notebook o en todas a la vez.

Devuelve línea + contexto. Sin notebook_id recorre todas las notebooks de la cuenta y etiqueta cada coincidencia con su origen (notebooks_scanned_ids dice cuáles se recorrieron); una notebook con problemas no aborta el barrido (notebook_errors con ref). Es literal salvo que uses literal=false.

Pregunta al notebook y devuelve respuesta con citas a fuentes. Consume cuota de chat y queda en el historial del notebook.

Lista las notas del notebook con una vista previa.

Lee una nota completa (paginada).

Lista los artefactos generados (informes, audio, cuestionarios, mapas mentales...) y su estado.

Lee en Markdown un informe (briefing, guía de estudio...), paginado.

Solo los informes (tipo report, los que crea generate_report): un archivo subido, un audio o una presentación no tienen texto que leer y la llamada lo dirá con el tipo que tiene en lugar del «no está listo» interno de NotebookLM.

Estado de una generación iniciada con generate_report (pending / in_progress / completed / failed).

Con wait_seconds > 0 espera activamente hasta el estado terminal (o agotar la espera) y devuelve final, para que el agente no tenga que consultar en bucle. Con 0 responde ya.

Cuota de la cuenta (ventanas de uso y acciones con capacidad restante).

Útil antes de lotes de ask_notebook/generate_report para no chocar con límites. No todas las cuentas exponen la cuota: si no, devuelve status: disabled y enabled: false — en ese caso confía en los límites por defecto y no reintentes.

Historial de chat del notebook: turnos (pregunta, respuesta) más recientes.

Los turnos vienen recortados y sin conversation_id: para repreguntar con contexto, usa el que devolvió ask_notebook.

Radiografía local de las fuentes: tamaño, palabras, encabezados y términos dominantes.

Sin notebook_id resume la caché entera por notebook (fuentes, caracteres y antigüedad), sin red ni cuota: es la vista para decidir sync_notebook o clear_cache. Con notebook_id mide fuente a fuente; con auto_sync=False mide solo lo ya cacheado y lista el resto en not_cached.

Descarga todas las fuentes del notebook en Markdown a la caché local (habilita keyword_search/grep sin esperas).

Exporta a .md (con front matter) un notebook completo o una sola fuente.

Notebook completo (incremental): solo reescribe las fuentes cuyo Markdown cambió —el resto conserva su exported_at—, deja INDEX.md + .manifest.json y borra los .md de fuentes que ya no existen (force reescribe todo). Una sola fuente: escribe ese documento y, con refresh, lo vuelve a descargar antes. directory elige el destino; los archivos quedan listos para las herramientas de archivos del agente.

Borra la caché local y las exportaciones (no toca nada en NotebookLM).

purge_all=True vacía por completo el estado local (útil antes de un refresco masivo); en ese caso no se requiere notebook_id.