Notebooklm mcp server

---

💡 O que é isso?

O Gemini Notebook do Google (renomeado de NotebookLM em julho de 2026) é o melhor mecanismo de respostas fundamentadas do mercado: ele só responde com base nas fontes que você fornece, com citações. Este servidor MCP entrega esse poder aos seus agentes de IA — Claude, Gemini, Antigravity, Cursor e qualquer outro cliente MCP — para que eles possam criar notebooks, executar Deep Research, gerar podcasts, vídeos, quizzes, flashcards, relatórios e mapas mentais, fazer anotações e compartilhar os resultados com sua equipe. Tudo programaticamente, com zero alucinações.

[!NOTE] NotebookLM agora é Gemini Notebook. O Google renomeou o produto em 16 de julho de 2026 (veja notebook.google). Mesmo produto, mesmos notebooks, mesma superfície de API — este servidor continua funcionando sem alterações, e o pacote npm mantém seu nome notebooklm-mcp-server.

🚀 Instalação

Opção 1 — Instalação global (recomendada)

npm install -g notebooklm-mcp-server

[!NOTE] O servidor verifica atualizações na inicialização e se mantém atualizado automaticamente.

Opção 2 — Instalação zero com NPX

npx -y notebooklm-mcp-server auth   # authenticate
npx -y notebooklm-mcp-server start  # run the server

🔑 Autenticação

1. Execute o login interativo (abre uma janela do Chromium):

npx notebooklm-mcp-server auth

2. Entre com sua conta do Google. Quando a lista de notebooks aparecer, os cookies de sessão (incluindo o token rotativo __Secure-1PSIDTS do Google) são capturados e salvos em ~/.notebooklm-mcp/auth.json.

3. Pronto — o servidor carrega a sessão automaticamente e atualiza o token rotativo por conta própria.

[!TIP] Se a sessão expirar, execute npx notebooklm-mcp-server auth novamente em um terminal e depois chame a ferramenta MCP refresh_auth (ou apenas reinicie seu cliente) para carregar os novos cookies sem reconfigurar nada.

⚡ Conecte Seu Cliente de IA

🤖 Claude Code

claude mcp add notebooklm -- npx -y notebooklm-mcp-server start

💬 Claude Desktop

Adicione em claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

🌌 Antigravity CLI

A CLI do Antigravity gerencia servidores MCP por meio de um arquivo de configuração JSON:

• Global: ~/.gemini/config/mcp_config.json
• Por workspace: .agents/mcp_config.json no seu projeto

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

Depois digite /mcp no painel de prompt do Antigravity para abrir o Gerenciador MCP: verifique o anel de status da conexão, recarregue a configuração ou inspecione os logs — sem necessidade de reiniciar. Seus agentes agora podem citar fontes reais em cada missão.

🖥️ Antigravity IDE

A IDE lê os mesmos arquivos de configuração que a CLI (~/.gemini/config/mcp_config.json ou .agents/mcp_config.json). Alternativamente, abra o painel MCP Store, escolha Adicionar servidor personalizado e cole o mesmo trecho JSON. Recarregue a lista de servidores e as ferramentas do NotebookLM aparecem na caixa de ferramentas do agente.

💎 Gemini CLI

gemini mcp add notebooklm --scope user -- npx -y notebooklm-mcp-server start

⌨️ Cursor

Adicione em .cursor/mcp.json no seu projeto (ou ~/.cursor/mcp.json globalmente):

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

🏄 Windsurf

Adicione o mesmo bloco mcpServers em ~/.codeium/windsurf/mcp_config.json.

🧩 VS Code (Cline)

No Cline: Servidores MCP → Configurar e adicione o mesmo bloco mcpServers mostrado acima.

📖 Referência de Ferramentas

47 ferramentas, agrupadas pelo que fazem. Assinaturas completas dos parâmetros estão em docs/TOOLS.md.

📒 Notebooks

Ferramenta	Descrição
notebook_list	Lista todos os notebooks com fontes e metadados
notebook_create	Cria um novo notebook
notebook_get	Obtém os detalhes e IDs de fontes de um notebook
notebook_rename	Renomeia um notebook
notebook_delete	Exclui um notebook (requer confirm)
notebook_summarize	Guia de IA do notebook: resumo + perguntas sugeridas
prompts_suggest	Prompts sugeridos por IA para perguntar sobre as fontes

🔗 Compartilhamento

Ferramenta	Descrição
notebook_share	Alterna link público e/ou gerencia colaboradores por e-mail
notebook_share_status	Lê a configuração de compartilhamento atual

🖇️ Fontes

Ferramenta	Descrição
notebook_add_url	Adiciona um site ou vídeo do YouTube como fonte
notebook_add_text	Adiciona texto colado como fonte
notebook_add_drive	Adiciona um documento do Google Drive como fonte
notebook_add_local_file	Envia um arquivo local PDF / TXT / Markdown
source_get_guide	Guia de IA para uma fonte: resumo + tópicos principais
source_rename	Renomeia uma fonte
source_check_freshness	Verifica se uma fonte de URL/Drive tem conteúdo mais recente
source_sync	Ressincroniza uma fonte do Drive com o conteúdo mais recente
source_delete	Exclui uma fonte (requer confirm)

💬 Chat

Ferramenta	Descrição
notebook_query	Faz perguntas sobre as fontes, com citações
chat_history_get	Lê as rodadas de perguntas e respostas da conversa mais recente
chat_history_delete	Limpa o histórico do chat (requer confirm)
chat_configure	Define a persona do chat (padrão / guia de aprendizado / personalizada) e o tamanho da resposta

🔍 Pesquisa

Ferramenta	Descrição
research_start	Inicia pesquisa na web ou no Drive (rápida ≈30s / profunda ≈5min)
research_poll	Verifica o progresso da pesquisa e as fontes descobertas
research_import	Importa as fontes descobertas para o notebook

🎨 Studio

Ferramenta	Descrição
audio_overview_create	Visão geral de áudio em formato podcast (formatos: mergulho profundo, resumo, crítica, debate)
video_overview_create	Visão geral em vídeo (9 estilos visuais, de quadro branco a anime)
report_create	Relatório escrito a partir das fontes
flashcards_create	Flashcards (opções de quantidade e dificuldade)
quiz_create	Quiz interativo (opções de quantidade e dificuldade)
infographic_create	Infográfico (paisagem / retrato / quadrado)
slide_deck_create	Apresentação de slides
data_table_create	Tabela de dados estruturados
studio_poll	Verifica o status de geração de todos os artefatos
studio_delete	Exclui um artefato do studio

📦 Artefatos

Ferramenta	Descrição
artifact_content_get	Busca conteúdo gerado (HTML de quiz/flashcards, JSON de mapa mental)
artifact_rename	Renomeia um artefato
artifact_export	Exporta um artefato para o Google Drive (Docs ou Sheets)

📝 Notas e Mapas Mentais

Ferramenta	Descrição
note_create	Cria uma nota
note_list	Lista todas as notas
note_update	Atualiza o conteúdo/título de uma nota
note_delete	Exclui uma nota (requer confirm)
mind_map_generate	Gera um JSON de mapa mental a partir das fontes
mind_map_save	Salva um mapa mental no notebook
mind_map_list	Lista mapas mentais salvos
mind_map_delete	Exclui um mapa mental

⚙️ Sistema

Ferramenta	Descrição
refresh_auth	Recarrega os cookies de sessão do disco após executar auth novamente

🧪 Receitas

Prompts reais que você pode colar em qualquer agente conectado — ele escolhe as ferramentas certas por conta própria.

🎙️ Da pergunta de pesquisa ao podcast

"Pesquise as últimas novidades sobre baterias de estado sólido com pesquisa aprofundada, crie um notebook chamado 'Solid State 2026' com as melhores fontes e gere uma visão geral de áudio resumida em inglês. Me dê o link quando terminar."

O agente encadeia notebook_create → research_start(mode: deep) → research_poll → research_import → audio_overview_create(format: brief) → studio_poll e retorna o URL do notebook com o podcast finalizado.

🎓 Kit de estudos a partir dos seus PDFs

"Pegue os três PDFs em ./lectures, coloque-os em um novo notebook e me faça um quiz difícil mais flashcards sobre os conceitos-chave. Mostre as perguntas do quiz aqui."

O agente executa notebook_add_local_file para cada PDF, depois quiz_create(difficulty: hard) + flashcards_create, verifica com studio_poll e extrai as perguntas com artifact_content_get.

👥 Briefing de equipe, compartilhado

"Monte um notebook de briefing a partir destes cinco links sobre nosso concorrente, escreva um relatório, exporte para o Google Docs e compartilhe o notebook com ana@example.com como visualizadora."

O agente encadeia notebook_add_url ×5 → report_create → studio_poll → artifact_export(format: docs) → notebook_share(user_email, user_role: viewer) — e seu colega encontra o notebook e o Doc esperando.

🛠️ Solução de Problemas

Sintoma	Correção
auth avisa que a API rejeitou seus cookies logo após o login	Sua conta do Google aplica Device Bound Session Credentials (DBSC) — ativado por padrão para contas do Workspace e a maioria das contas pessoais. O DBSC vincula a sessão a uma chave mantida no dispositivo, então cookies exportados do navegador são recusados pela API. Clientes de extração de cookies não conseguem contornar isso; use uma conta do Google sem aplicação de DBSC.
Authentication expired logo após fazer login	Atualize para ≥ 3.0.8 — versões mais antigas perdiam o token rotativo __Secure-1PSIDTS do Google. O servidor agora captura e atualiza automaticamente.
Authentication failed após semanas de uso	As sessões do Google eventualmente expiram. Execute npx notebooklm-mcp-server auth e depois chame a ferramenta refresh_auth.
Geração no Studio travada em pending	Fontes longas demoram um pouco — continue verificando studio_poll; áudio/vídeo podem levar vários minutos.
Erros de RPC após uma atualização do Google	O Google ocasionalmente rotaciona rótulos internos de build. Atualize o pacote; se persistir, abra uma issue.

🧑‍💻 Desenvolvimento

git clone https://github.com/moodRobotics/notebooklm-mcp-server.git
cd notebooklm-mcp-server
npm install
npm run build
npm run typecheck

Notas de arquitetura estão em docs/ARCHITECTURE.md, o roadmap em docs/ROADMAP.md.

🌐 Localização

Este README está disponível em English, Español, Français, Português e Deutsch. Se você editar um, mantenha os outros sincronizados (npm run docs:check).

📄 Licença

MIT — Desenvolvido com ❤️ por moodRobotics.

[!IMPORTANT] Este é um projeto comunitário não oficial. Não é afiliado ou endossado pelo Google. Ele depende de APIs internas de engenharia reversa que podem mudar sem aviso; use-o com uma conta do Google com a qual você se sinta confortável em automatizar.