NotebookLM (Gemini Notebook) MCP Server by useapi.net

Google NotebookLM: cadernos, fontes, chat com citações, podcasts, vídeos, slides, quizzes, pesquisa. Terceirizado, pago (US$ 15/mês), funciona na sua própria conta Google.

Servidor MCP hospedado

npx add-mcp 'https://api.useapi.net/v1/gemini-notebook/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Skip to main content

Servidor MCP NotebookLM

15 de outubro de 2026

Independent third-party service, see Legal

Sumário

  1. Endpoint e autorização
  2. Configuração
  3. Ferramentas
  4. Trabalhos de longa duração
  5. Exemplos de prompts
  6. Limites e observações

O servidor MCP NotebookLM da useapi.net (servidor MCP Gemini Notebook) permite que um assistente de IA, como Claude Code, Cursor ou VS Code Copilot, use o NotebookLM, que o Google renomeou para Gemini Notebook, nas suas próprias contas do Google. É um servidor hospedado do Model Context Protocol com 57 ferramentas: criar cadernos, adicionar páginas da web, vídeos do YouTube, arquivos, arquivos do Google Drive e ebooks do Google Play Books como fontes, fazer perguntas respondidas com citações e gerar todas as saídas do Studio, desde Audio Overviews e Video Overviews até apresentações de slides, infográficos, questionários e mapas mentais. Cada ferramenta chama a API do Gemini Notebook, portanto as mesmas regras e limites se aplicam. Nada precisa ser instalado ou hospedado.

Existe um servidor MCP NotebookLM? Sim. A useapi.net, um serviço de terceiros não afiliado ao Google, hospeda um servidor MCP NotebookLM (Gemini Notebook) em https://api.useapi.net/v1/gemini-notebook/mcp com 57 ferramentas para cadernos, fontes, chat e todas as saídas do Studio, na sua própria conta do Google, sem necessidade de instalação.

Prefere REST? Tutoriais: Opções da API NotebookLM em 2026 · Como automatizar o NotebookLM com a API do Gemini Notebook · Código: github.com/useapi/notebooklm-api

Veja todos os servidores MCP da useapi.net em Model Matrix & MCP.

Endpoint e autorização

https://api.useapi.net/v1/gemini-notebook/mcp
  • Transporte: Streamable HTTP.
  • Listado no registro oficial de MCP como net.useapi/gemini-notebook, para que clientes e diretórios MCP que leem o registro possam encontrá-lo por esse nome.
  • Autorização: seu token de API da useapi.net no cabeçalho Authorization: Bearer …, veja Configurar useapi.net.
  • Você precisa de pelo menos uma conta do Google adicionada com Configurar Gemini Notebook. Adicionar e remover contas não está disponível via MCP: use POST /accounts ou a página de configuração.

Configuração

Substitua YOUR_API_TOKEN pelo seu token de API da 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

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "useapi-gemini-notebook": {
      "url": "https://api.useapi.net/v1/gemini-notebook/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code

Em .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 e outros clientes

Qualquer cliente que suporte servidores MCP remotos via HTTP com cabeçalhos personalizados funciona. O formato JSON usual:

{
  "mcpServers": {
    "useapi-gemini-notebook": {
      "serverUrl": "https://api.useapi.net/v1/gemini-notebook/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Alguns clientes nomeiam o campo de endereço como url em vez de serverUrl.

Teste com 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"}'

A primeira chamada responde com o nome do servidor useapi-gemini-notebook e suas instruções para o assistente; a segunda, com as 57 ferramentas.

Ferramentas

Cadernos, fontes, notas e artefatos são nomeados pelos ids que as ferramentas retornam, e cada id carrega sua conta. Ferramentas que operam em uma conta usam email, que pode ser omitido quando o token de API tem uma única conta.

Contas

FerramentaO que fazPrincipais parâmetros
notebook_list_accountsLista suas contas com saúde, maxJobs, trabalhos em execução e uso conhecido recente. 
notebook_get_accountLê uma conta ao vivo: plano, limites, uso de 5 horas e semanal, e o custo estimado de cada ação do Studio.email
notebook_update_accountDefine maxJobs e o idioma de saída dos artefatos do Studio.email, maxJobs, outputLanguage

Cadernos e coleções

FerramentaO que fazPrincipais parâmetros
notebook_list_notebooksLista os cadernos de uma conta ou de todas.email
notebook_get_notebookLê um caderno com suas fontes e artefatos, e se cada fonte está pronta.notebook
notebook_create_notebookCria um caderno vazio.email, title
notebook_rename_notebookRenomeia um caderno.notebook, title
notebook_delete_notebookExclui um caderno com tudo o que há nele.notebook
notebook_copy_notebookCopia um caderno com suas fontes.notebook, title
notebook_get_guideRetorna o resumo do Google do caderno, com perguntas e relatórios sugeridos.notebook
notebook_list_collectionsLista as coleções (pastas de cadernos).email
notebook_create_collectionCria uma coleção.name, emoji, email
notebook_update_collectionRenomeia uma coleção, ou adiciona e remove cadernos.collection, name, emoji, addNotebooks, removeNotebooks
notebook_delete_collectionExclui uma coleção. Os cadernos dela permanecem.collection

Fontes

FerramentaO que fazPrincipais parâmetros
notebook_add_sourcesAdiciona páginas da web, vídeos do YouTube, texto colado, arquivos do Google Drive e ebooks do Google Play Books em uma única chamada.notebook, urls, text, title, drive, books
notebook_upload_sourceAdiciona um arquivo (PDF, Word, PowerPoint, EPUB, Markdown, texto, CSV, áudio, vídeo ou imagem) de uma URL https pública de até 50 MB, ou enviado como contentBase64.notebook, url ou contentBase64, name, mimeType
notebook_get_sourceLê uma fonte com o resumo do Google e os principais tópicos, e com content: true seu texto completo.source, content
notebook_rename_sourceRenomeia uma fonte.source, title
notebook_delete_sourceRemove uma fonte.source
notebook_sync_sourceReimporta uma fonte do Google Drive depois que o arquivo dela mudou.source
notebook_search_sourcesEncontra as passagens que correspondem a uma consulta, melhores primeiro.notebook, query, sources, limit
notebook_append_to_sourceAdiciona texto ao final de uma fonte.source, text, title
notebook_copy_sourcesCopia fontes para outro caderno da mesma conta.sources, notebook
notebook_list_play_booksLista a biblioteca do Google Play Books da conta e quais livros podem ser adicionados.email

Chat, notas, rótulos e compartilhamento

FerramentaO que fazPrincipais parâmetros
notebook_askFaz uma pergunta respondida a partir das fontes com citações numeradas. Passe conversation para fazer uma pergunta de acompanhamento.notebook, question, conversation, sources
notebook_get_chatLê uma conversa.notebook, conversation
notebook_delete_chatExclui uma conversa.notebook, conversation
notebook_set_chat_settingsDefine o objetivo do chat (padrão, guia de aprendizado ou uma persona personalizada) e o tamanho da resposta.notebook, goal, persona, length
notebook_list_notes, notebook_get_note, notebook_create_note, notebook_update_note, notebook_delete_noteGerenciam notas. notebook_create_note com conversation salva um chat inteiro como nota.notebook, note, title, content, conversation
notebook_note_to_sourceTransforma uma nota em fonte.note
notebook_create_mindmap_noteCria um mapa mental das fontes como nota, em uma única chamada.notebook, sources, language, instructions
notebook_list_labels, notebook_create_labels, notebook_update_label, notebook_delete_labelAgrupam fontes com rótulos, nomeados ou atribuídos pelo Google por tópico (auto).notebook, label, auto, name, emoji, addSources, removeSources
notebook_get_sharing, notebook_set_sharingLeem e alteram quem pode abrir um caderno, seu link, cópias e nível de visualização.notebook, people, link, allowCopies, viewLevel

Studio e pesquisa

FerramentaO que fazPrincipais parâmetros
notebook_generate_artifactGera um Audio Overview, Video Overview, relatório, relatório interativo, tabela de dados, questionário, flashcards, infográfico, apresentação de slides ou mapa mental. Sem notebook, executa em uma única etapa a partir de urls ou text.type, notebook, sources, urls, text e as opções do tipo: format, length, style, language, instructions, quantity, difficulty, orientation, detail
notebook_get_jobLê um trabalho e, com wait: true, aguarda a conclusão dele.jobid, wait
notebook_list_jobsLista os trabalhos em execução de cada conta e o uso conhecido recente. 
notebook_cancel_jobPara de rastrear um trabalho e libera seu espaço. O Google ainda pode concluir o artefato, e o uso é cobrado de qualquer forma.jobid
notebook_list_artifactsLista os artefatos de um caderno.notebook
notebook_get_artifactLê um artefato: arquivos com URLs de download, o texto de um relatório, o JSON de um questionário, flashcards, mapa mental ou tabela, textos de slides e os itens sugeridos de um relatório interativo.artifact
notebook_get_slideRetorna um slide de uma apresentação de slides, ou um infográfico, como imagem que o assistente pode ver, por exemplo após revisar um slide.artifact, slide, width
notebook_rename_artifact, notebook_delete_artifactRenomeiam ou excluem um artefato. Excluir um item sugerido o dispensa.artifact, title
notebook_retry_artifactGera novamente um artefato que falhou.artifact
notebook_revise_slideAltera um slide de uma apresentação de slides com um prompt.artifact, slide, prompt
notebook_generate_suggested_itemGera um item que um relatório interativo sugere, como sugerido ou com opções próprias.artifact e as opções do tipo
notebook_export_artifactExporta um relatório para o Google Docs ou uma tabela para o Google Sheets e retorna sua URL.artifact, destination, title
notebook_copy_artifactsCopia artefatos concluídos para outro caderno.artifacts, notebook
notebook_researchPermite que o Google encontre fontes: fast (Discover) ou deep (Deep Research com relatório), na web ou no Google Drive da conta.notebook, query, type, source
notebook_import_researchAdiciona as fontes que um trabalho de pesquisa encontrou e o relatório do Deep Research.jobid, urls, report

As opções de cada tipo do Studio estão listadas em POST /artifacts. O esquema completo de entrada de cada ferramenta vem de tools/list.

Trabalhos de longa duração

Clientes MCP geralmente desistem de uma chamada de ferramenta após cerca de um minuto, então uma ferramenta aguarda até cerca de 50 segundos:

  • Um questionário, flashcards ou um mapa mental geralmente termina nesse tempo, e a ferramenta retorna o resultado.
  • Um Audio Overview, um Video Overview, uma apresentação de slides ou uma pesquisa demoram mais. A ferramenta então retorna o jobid, e notebook_get_job com wait: true retoma o trabalho. Peça ao assistente para continuar verificando até que esteja concluído.
  • notebook_ask responde em cerca de 5 a 40 segundos.

Clientes que solicitam notificações de progresso recebem uma a cada cerca de 10 segundos enquanto uma ferramenta aguarda.

Os arquivos retornam como URLs de download. Busque-os com o mesmo cabeçalho Authorization. Um infográfico, e o primeiro slide de uma apresentação de slides, também retornam como imagem que o assistente pode ver.

Exemplos de prompts

  • “Crie um notebook a partir destes três artigos e faça para mim um podcast de 10 minutos de mergulho profundo sobre eles.”
  • “Envie este PDF e peça ao notebook quais riscos ele lista, com citações.”
  • “Faça um quiz de 10 perguntas fáceis do meu notebook Apollo e depois flashcards sobre o mesmo tópico.”
  • “Faça um infográfico de retrato em estilo sketch-note a partir do notebook e mostre para mim.”
  • “Execute Deep Research sobre baterias de estado sólido no meu notebook Batteries e importe as fontes e o relatório.”
  • “Faça um relatório interativo para uma criança de 12 anos e depois gere o deck de slides que ele sugere.”
  • “Exporte o relatório de briefing para o Google Docs e me dê o link.”

Limites e observações

  • As ferramentas usam suas contas do Google e as mesmas regras da API REST, como maxJobs para Studio e trabalhos de pesquisa. A saída do Studio conta contra o uso do Google da conta, veja Limites de uso.
  • Conectores personalizados no claude.ai precisam de login OAuth, que este servidor ainda não suporta. Use o Claude Code ou outro cliente que possa enviar um cabeçalho Authorization.
  • Um cliente pode enviar até 20 solicitações JSON-RPC em um único lote.
  • Se o cliente enviar um cabeçalho MCP-Protocol-Version, ele deve ser uma das versões suportadas: 2025-06-18, 2025-03-26 ou 2024-11-05.
  • Cada chamada de ferramenta aparece nas suas estatísticas de uso ( bot=gemini-notebook) como modelo mcp, com o nome da ferramenta como status, ou failed.

Tutoriais para a Gemini Notebook API v1:

{ "@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" } ] }