NotebookLM (Gemini Notebook) MCP Server by useapi.net
Google NotebookLM: cuadernos, fuentes, chat citado, podcasts, video, diapositivas, cuestionarios, investigación. De terceros, de pago ($15/mes), funciona con tu propia cuenta de Google.
Servidor MCP alojado
npx add-mcp 'https://api.useapi.net/v1/gemini-notebook/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP de NotebookLM
15 de octubre de 2026
Tabla de contenidos
- Endpoint y autorización
- Configuración
- Herramientas
- Trabajos de larga duración
- Ejemplos de indicaciones
- Límites y notas
El servidor MCP de NotebookLM de useapi.net (servidor MCP de Gemini Notebook) permite que un asistente de IA como Claude Code, Cursor o VS Code Copilot use NotebookLM, que Google renombró como Gemini Notebook, en tus propias cuentas de Google. Es un servidor alojado de Model Context Protocol con 57 herramientas: crear cuadernos, añadir páginas web, videos de YouTube, archivos, archivos de Google Drive y libros electrónicos de Google Play Books como fuentes, hacer preguntas respondidas con citas, y generar cada salida de Studio, desde Resúmenes de Audio y Resúmenes de Video hasta presentaciones de diapositivas, infografías, cuestionarios y mapas mentales. Cada herramienta llama a la API de Gemini Notebook, por lo que se aplican las mismas reglas y límites. No es necesario instalar ni alojar nada.
¿Existe un servidor MCP de NotebookLM? Sí. useapi.net, un servicio de terceros no afiliado a Google, aloja un servidor MCP de NotebookLM (Gemini Notebook) en https://api.useapi.net/v1/gemini-notebook/mcp con 57 herramientas para cuadernos, fuentes, chat y cada salida de Studio, en tu propia cuenta de Google, sin necesidad de instalar nada.
¿Prefieres REST? Tutoriales: Opciones de la API de NotebookLM en 2026 · Cómo automatizar NotebookLM con la API de Gemini Notebook · Código: github.com/useapi/notebooklm-api
Consulta todos los servidores MCP de useapi.net en Model Matrix & MCP.
Endpoint y autorización
https://api.useapi.net/v1/gemini-notebook/mcp
- Transporte: HTTP Streamable.
- Listado en el Registro oficial de MCP como
net.useapi/gemini-notebook, por lo que los clientes y directorios de MCP que lean el registro pueden encontrarlo por ese nombre. - Autorización: tu token de API de useapi.net en el encabezado
Authorization: Bearer …, consulta Configurar useapi.net. - Necesitas al menos una cuenta de Google añadida con Configurar Gemini Notebook. Añadir y eliminar cuentas no está disponible a través de MCP: usa POST /accounts o la página de configuración.
Configuración
Reemplaza YOUR_API_TOKEN con tu token de API de useapi.net.
Claude Code
claude mcp add --transport http useapi-gemini-notebook https://api.useapi.net/v1/gemini-notebook/mcp --header "Authorization: Bearer YOUR_API_TOKEN"
Cursor
En ~/.cursor/mcp.json:
{
"mcpServers": {
"useapi-gemini-notebook": {
"url": "https://api.useapi.net/v1/gemini-notebook/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
VS Code
En .vscode/mcp.json:
{
"servers": {
"useapi-gemini-notebook": {
"type": "http",
"url": "https://api.useapi.net/v1/gemini-notebook/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Windsurf y otros clientes
Cualquier cliente que admita servidores MCP remotos a través de HTTP con encabezados personalizados funciona. La forma habitual en JSON:
{
"mcpServers": {
"useapi-gemini-notebook": {
"serverUrl": "https://api.useapi.net/v1/gemini-notebook/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Algunos clientes nombran el campo de dirección url en lugar de serverUrl.
Pruébalo con curl
curl -s https://api.useapi.net/v1/gemini-notebook/mcp \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
curl -s https://api.useapi.net/v1/gemini-notebook/mcp \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
La primera llamada responde con el nombre del servidor useapi-gemini-notebook y sus instrucciones para el asistente, la segunda con las 57 herramientas.
Herramientas
Los cuadernos, fuentes, notas y artefactos se nombran por los ids que devuelven las herramientas, y cada id lleva su cuenta. Las herramientas que trabajan en una cuenta toman email, que se puede omitir cuando el token de API tiene una sola cuenta.
Cuentas
| Herramienta | Qué hace | Parámetros principales |
|---|---|---|
notebook_list_accounts | Lista tus cuentas con estado de salud, maxJobs, trabajos en ejecución y uso conocido reciente. | |
notebook_get_account | Lee una cuenta en vivo: plan, límites, uso de 5 horas y semanal, y el costo estimado de cada acción de Studio. | email |
notebook_update_account | Establece maxJobs y el idioma de salida de los artefactos de Studio. | email, maxJobs, outputLanguage |
Cuadernos y colecciones
| Herramienta | Qué hace | Parámetros principales |
|---|---|---|
notebook_list_notebooks | Lista los cuadernos de una cuenta o de todas. | email |
notebook_get_notebook | Lee un cuaderno con sus fuentes y artefactos, y si cada fuente está lista. | notebook |
notebook_create_notebook | Crea un cuaderno vacío. | email, title |
notebook_rename_notebook | Renombra un cuaderno. | notebook, title |
notebook_delete_notebook | Elimina un cuaderno con todo su contenido. | notebook |
notebook_copy_notebook | Copia un cuaderno con sus fuentes. | notebook, title |
notebook_get_guide | Devuelve el resumen de Google del cuaderno, con preguntas e informes sugeridos. | notebook |
notebook_list_collections | Lista las colecciones (carpetas de cuadernos). | email |
notebook_create_collection | Crea una colección. | name, emoji, email |
notebook_update_collection | Renombra una colección, o añade y elimina cuadernos. | collection, name, emoji, addNotebooks, removeNotebooks |
notebook_delete_collection | Elimina una colección. Sus cuadernos permanecen. | collection |
Fuentes
| Herramienta | Qué hace | Parámetros principales |
|---|---|---|
notebook_add_sources | Añade páginas web, videos de YouTube, texto pegado, archivos de Google Drive y libros electrónicos de Google Play Books en una sola llamada. | notebook, urls, text, title, drive, books |
notebook_upload_source | Añade un archivo (PDF, Word, PowerPoint, EPUB, Markdown, texto, CSV, audio, video o imagen) desde una URL https pública de hasta 50 MB, o enviado como contentBase64. | notebook, url o contentBase64, name, mimeType |
notebook_get_source | Lee una fuente con el resumen de Google y los temas clave, y con content: true su texto completo. | source, content |
notebook_rename_source | Renombra una fuente. | source, title |
notebook_delete_source | Elimina una fuente. | source |
notebook_sync_source | Reimporta una fuente de Google Drive después de que su archivo haya cambiado. | source |
notebook_search_sources | Encuentra los pasajes que coinciden con una consulta, mejor primero. | notebook, query, sources, limit |
notebook_append_to_source | Añade texto al final de una fuente. | source, text, title |
notebook_copy_sources | Copia fuentes a otro cuaderno de la misma cuenta. | sources, notebook |
notebook_list_play_books | Lista la biblioteca de Google Play Books de la cuenta y qué libros se pueden añadir. | email |
Chat, notas, etiquetas y uso compartido
| Herramienta | Qué hace | Parámetros principales |
|---|---|---|
notebook_ask | Hace una pregunta respondida desde las fuentes con citas numeradas. Pasa conversation para hacer una pregunta de seguimiento. | notebook, question, conversation, sources |
notebook_get_chat | Lee una conversación. | notebook, conversation |
notebook_delete_chat | Elimina una conversación. | notebook, conversation |
notebook_set_chat_settings | Establece el objetivo del chat (predeterminado, guía de aprendizaje o una persona personalizada) y la longitud de la respuesta. | notebook, goal, persona, length |
notebook_list_notes, notebook_get_note, notebook_create_note, notebook_update_note, notebook_delete_note | Gestiona notas. notebook_create_note con conversation guarda un chat completo como nota. | notebook, note, title, content, conversation |
notebook_note_to_source | Convierte una nota en una fuente. | note |
notebook_create_mindmap_note | Crea un mapa mental de las fuentes como nota, en una sola llamada. | notebook, sources, language, instructions |
notebook_list_labels, notebook_create_labels, notebook_update_label, notebook_delete_label | Agrupa fuentes con etiquetas, nombradas o asignadas por Google por tema (auto). | notebook, label, auto, name, emoji, addSources, removeSources |
notebook_get_sharing, notebook_set_sharing | Lee y cambia quién puede abrir un cuaderno, su enlace, copias y nivel de vista. | notebook, people, link, allowCopies, viewLevel |
Studio e investigación
| Herramienta | Qué hace | Parámetros principales |
|---|---|---|
notebook_generate_artifact | Genera un Resumen de Audio, Resumen de Video, informe, informe interactivo, tabla de datos, cuestionario, tarjetas de memoria, infografía, presentación de diapositivas o mapa mental. Sin notebook se ejecuta de una sola vez desde urls o text. | type, notebook, sources, urls, text, y las opciones del tipo: format, length, style, language, instructions, quantity, difficulty, orientation, detail |
notebook_get_job | Lee un trabajo, y con wait: true espera a que termine. | jobid, wait |
notebook_list_jobs | Lista los trabajos en ejecución de cada cuenta y el uso conocido reciente. | |
notebook_cancel_job | Deja de rastrear un trabajo y libera su espacio. Google puede aún terminar el artefacto, y su uso se gasta de cualquier manera. | jobid |
notebook_list_artifacts | Lista los artefactos de un cuaderno. | notebook |
notebook_get_artifact | Lee un artefacto: archivos con URLs de descarga, el texto de un informe, el JSON de un cuestionario, tarjetas de memoria, mapa mental o tabla, textos de diapositivas, y los elementos sugeridos de un informe interactivo. | artifact |
notebook_get_slide | Devuelve una diapositiva de una presentación, o una infografía, como imagen que el asistente puede ver, por ejemplo después de revisar una diapositiva. | artifact, slide, width |
notebook_rename_artifact, notebook_delete_artifact | Renombra o elimina un artefacto. Eliminar un elemento sugerido lo descarta. | artifact, title |
notebook_retry_artifact | Genera de nuevo un artefacto fallido. | artifact |
notebook_revise_slide | Cambia una diapositiva de una presentación con una indicación. | artifact, slide, prompt |
notebook_generate_suggested_item | Genera un elemento que un informe interactivo sugiere, como se sugiere o con sus propias opciones. | artifact y las opciones del tipo |
notebook_export_artifact | Exporta un informe a Google Docs o una tabla a Google Sheets y devuelve su URL. | artifact, destination, title |
notebook_copy_artifacts | Copia artefactos terminados a otro cuaderno. | artifacts, notebook |
notebook_research | Permite que Google encuentre fuentes: fast (Discover) o deep (Deep Research con un informe), en la web o en el Google Drive de la cuenta. | notebook, query, type, source |
notebook_import_research | Añade las fuentes que un trabajo de investigación encontró, y el informe de Deep Research. | jobid, urls, report |
Las opciones de cada tipo de Studio se enumeran en POST /artifacts. El esquema de entrada completo de cada herramienta proviene de tools/list.
Trabajos de larga duración
Los clientes de MCP suelen abandonar una llamada de herramienta después de aproximadamente un minuto, por lo que una herramienta espera hasta unos 50 segundos:
- Un cuestionario, tarjetas de memoria o un mapa mental suele terminar en ese tiempo, y la herramienta devuelve el resultado.
- Un Resumen de Audio, un Resumen de Video, una presentación de diapositivas o una investigación tardan más. La herramienta entonces devuelve el
jobid, ynotebook_get_jobconwait: truelo retoma. Pide al asistente que siga comprobando hasta que termine. notebook_askresponde en unos 5 a 40 segundos.
Los clientes que solicitan notificaciones de progreso reciben una aproximadamente cada 10 segundos mientras una herramienta espera.
Los archivos se devuelven como URLs de descarga. Recupéralos con el mismo encabezado Authorization. Una infografía, y la primera diapositiva de una presentación, también se devuelven como una imagen que el asistente puede ver.
Ejemplos de indicaciones
- “Crea un notebook a partir de estos tres artículos y hazme un podcast de inmersión profunda de 10 minutos sobre ellos.”
- “Sube este PDF y pregúntale al notebook qué riesgos enumera, con citas.”
- “Haz un cuestionario de 10 preguntas fáciles de mi notebook de Apollo, y luego tarjetas de memoria sobre el mismo tema.”
- “Haz un infográfico de retrato en estilo sketch-note a partir del notebook, y muéstramelo.”
- “Ejecuta Deep Research sobre baterías de estado sólido en mi notebook de Baterías e importa las fuentes y el informe.”
- “Haz un informe interactivo para un niño de 12 años, y luego genera la presentación de diapositivas que sugiera.”
- “Exporta el informe de briefing a Google Docs y dame el enlace.”
Límites y notas
- Las herramientas usan tus cuentas de Google y las mismas reglas que la API REST, como
maxJobspara Studio y trabajos de investigación. La salida de Studio cuenta contra el uso de Google de la cuenta, consulta Límites de uso. - Los conectores personalizados en claude.ai requieren inicio de sesión OAuth, que este servidor aún no admite. Usa Claude Code u otro cliente que pueda enviar un encabezado
Authorization. - Un cliente puede enviar hasta 20 solicitudes JSON-RPC en un solo lote.
- Si el cliente envía un encabezado
MCP-Protocol-Version, debe ser una de las versiones compatibles:2025-06-18,2025-03-26o2024-11-05. - Cada llamada a una herramienta aparece en tus estadísticas de uso (
bot=gemini-notebook) como modelomcp, con el nombre de la herramienta como su estado, ofailed.
Tutoriales para la API de Gemini Notebook v1:
- Opciones de la API de NotebookLM en 2026: API empresarial de Google, bibliotecas gratuitas o una API alojada
- Cómo automatizar NotebookLM con la API de Gemini Notebook: Deep Research, chat, resúmenes de audio y mucho más
- Convierte una página web o un video de YouTube en un podcast con NotebookLM: un ejemplo real
- Cómo convertir páginas web, videos de YouTube y fuentes RSS en podcasts de NotebookLM con n8n
- Tutorial en chino (中文教程): 用 NotebookLM API 生成中文播客
{ "@context": "https://schema.org", "@type": "APIReference", "name": "NotebookLM MCP Server (Gemini Notebook): Hosted, 57 Tools", "url": "https://useapi.net/docs/api-gemini-notebook-v1/mcp", "inLanguage": "en", "isAccessibleForFree": true, "description": "Connect Claude Code, Cursor, VS Code or any MCP client to the hosted useapi.net NotebookLM (Gemini Notebook) MCP server: 57 tools for notebooks, sources, chat and Studio.", "about": "Gemini Notebook API v1", "isPartOf": { "@type": "APIReference", "name": "Gemini Notebook API v1" }, "publisher": { "@type": "Organization", "name": "useapi.net", "url": "https://useapi.net", "logo": { "@type": "ImageObject", "url": "https://useapi.net/assets/brand/useapi-logo-512.png" }, "alternateName": ["useapi", "UseAPI"], "sameAs": ["https://discord.gg/w28uK3cnmF", "https://t.me/use_api", "https://github.com/useapi", "https://bsky.app/profile/useapi.net", "https://www.youtube.com/@useapi-net"] }, "documentationOf": { "@type": "WebAPI", "name": "useapi.net REST API", "documentation": "https://useapi.net/llms.txt", "termsOfService": "https://useapi.net/docs/legal" } }
{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://useapi.net/" }, { "@type": "ListItem", "position": 2, "name": "Gemini Notebook API v1", "item": "https://useapi.net/docs/api-gemini-notebook-v1" }, { "@type": "ListItem", "position": 3, "name": "MCP Server", "item": "https://useapi.net/docs/api-gemini-notebook-v1/mcp" } ] }