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
Servidor MCP NotebookLM
15 de outubro de 2026
Sumário
- Endpoint e autorização
- Configuração
- Ferramentas
- Trabalhos de longa duração
- Exemplos de prompts
- 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
| Ferramenta | O que faz | Principais parâmetros |
|---|---|---|
notebook_list_accounts | Lista suas contas com saúde, maxJobs, trabalhos em execução e uso conhecido recente. | |
notebook_get_account | Lê 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_account | Define maxJobs e o idioma de saída dos artefatos do Studio. | email, maxJobs, outputLanguage |
Cadernos e coleções
| Ferramenta | O que faz | Principais parâmetros |
|---|---|---|
notebook_list_notebooks | Lista os cadernos de uma conta ou de todas. | email |
notebook_get_notebook | Lê um caderno com suas fontes e artefatos, e se cada fonte está pronta. | notebook |
notebook_create_notebook | Cria um caderno vazio. | email, title |
notebook_rename_notebook | Renomeia um caderno. | notebook, title |
notebook_delete_notebook | Exclui um caderno com tudo o que há nele. | notebook |
notebook_copy_notebook | Copia um caderno com suas fontes. | notebook, title |
notebook_get_guide | Retorna o resumo do Google do caderno, com perguntas e relatórios sugeridos. | notebook |
notebook_list_collections | Lista as coleções (pastas de cadernos). | email |
notebook_create_collection | Cria uma coleção. | name, emoji, email |
notebook_update_collection | Renomeia uma coleção, ou adiciona e remove cadernos. | collection, name, emoji, addNotebooks, removeNotebooks |
notebook_delete_collection | Exclui uma coleção. Os cadernos dela permanecem. | collection |
Fontes
| Ferramenta | O que faz | Principais parâmetros |
|---|---|---|
notebook_add_sources | Adiciona 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_source | Adiciona 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_source | Lê uma fonte com o resumo do Google e os principais tópicos, e com content: true seu texto completo. | source, content |
notebook_rename_source | Renomeia uma fonte. | source, title |
notebook_delete_source | Remove uma fonte. | source |
notebook_sync_source | Reimporta uma fonte do Google Drive depois que o arquivo dela mudou. | source |
notebook_search_sources | Encontra as passagens que correspondem a uma consulta, melhores primeiro. | notebook, query, sources, limit |
notebook_append_to_source | Adiciona texto ao final de uma fonte. | source, text, title |
notebook_copy_sources | Copia fontes para outro caderno da mesma conta. | sources, notebook |
notebook_list_play_books | Lista a biblioteca do Google Play Books da conta e quais livros podem ser adicionados. | email |
Chat, notas, rótulos e compartilhamento
| Ferramenta | O que faz | Principais parâmetros |
|---|---|---|
notebook_ask | Faz 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_chat | Lê uma conversa. | notebook, conversation |
notebook_delete_chat | Exclui uma conversa. | notebook, conversation |
notebook_set_chat_settings | Define 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_note | Gerenciam notas. notebook_create_note com conversation salva um chat inteiro como nota. | notebook, note, title, content, conversation |
notebook_note_to_source | Transforma uma nota em fonte. | note |
notebook_create_mindmap_note | Cria 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_label | Agrupam 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_sharing | Leem 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
| Ferramenta | O que faz | Principais parâmetros |
|---|---|---|
notebook_generate_artifact | Gera 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_job | Lê um trabalho e, com wait: true, aguarda a conclusão dele. | jobid, wait |
notebook_list_jobs | Lista os trabalhos em execução de cada conta e o uso conhecido recente. | |
notebook_cancel_job | Para 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_artifacts | Lista os artefatos de um caderno. | notebook |
notebook_get_artifact | Lê 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_slide | Retorna 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_artifact | Renomeiam ou excluem um artefato. Excluir um item sugerido o dispensa. | artifact, title |
notebook_retry_artifact | Gera novamente um artefato que falhou. | artifact |
notebook_revise_slide | Altera um slide de uma apresentação de slides com um prompt. | artifact, slide, prompt |
notebook_generate_suggested_item | Gera 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_artifact | Exporta um relatório para o Google Docs ou uma tabela para o Google Sheets e retorna sua URL. | artifact, destination, title |
notebook_copy_artifacts | Copia artefatos concluídos para outro caderno. | artifacts, notebook |
notebook_research | Permite 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_research | Adiciona 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, enotebook_get_jobcomwait: trueretoma o trabalho. Peça ao assistente para continuar verificando até que esteja concluído. notebook_askresponde 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
maxJobspara 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-26ou2024-11-05. - Cada chamada de ferramenta aparece nas suas estatísticas de uso (
bot=gemini-notebook) como modelomcp, com o nome da ferramenta como status, oufailed.
Tutoriais para a Gemini Notebook API v1:
- Opções da API NotebookLM em 2026: API Enterprise do Google, Bibliotecas Gratuitas ou uma API Hospedada
- Como Automatizar o NotebookLM com a API Gemini Notebook: Deep Research, Chat, Audio Overviews e Muito Mais
- Transforme uma Página da Web ou Vídeo do YouTube em um Podcast com o NotebookLM: Um Exemplo Real
- Como Transformar Páginas da Web, Vídeos do YouTube e Feeds RSS em Podcasts do NotebookLM com n8n
- Tutorial em chinês (中文教程): 用 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" } ] }