Notebooklm mcp server

NotebookLM MCP Server

Deixe seus agentes de IA conversarem diretamente com o Google NotebookLM para obter respostas sem alucinações.

English • Español • Français • Português • Deutsch

Instalação • Autenticação • Início Rápido • Claude Code • Documentação • Desenvolvimento

A Solução

O NotebookLM MCP Server traz o poder do Google NotebookLM diretamente para o seu fluxo de trabalho aumentado por IA. Construído nativamente em TypeScript usando o Model Context Protocol, ele permite que agentes leiam, pesquisem e gerenciem seus notebooks como se fossem arquivos locais.

---

🚀 Instalação

1. Instalação Global (Recomendada)

Você pode instalar o servidor diretamente do NPM:

npm install -g notebooklm-mcp-server

[!NOTE] Atualização automática: O servidor verifica automaticamente novas versões na inicialização. Se houver uma atualização, ele se instalará e pedirá que você reinicie para garantir que sempre tenha as correções mais recentes do Google.

2. Uso direto com NPX (Zero-Config)

Se você não quiser instalá-lo globalmente, pode executá-lo diretamente:

npx notebooklm-mcp-server auth   # To log in
npx notebooklm-mcp-server start  # To run the server

---

🔑 Autenticação

Antes de usar o servidor, você deve vinculá-lo à sua Conta do Google. Esta versão usa uma sessão segura e persistente no navegador:

1. Execute o comando de autenticação:

   npx notebooklm-mcp-server auth
   

2. Uma janela do navegador será aberta. Entre com sua conta do Google.
3. Feche o navegador assim que ver seus notebooks. Sua sessão agora está salva com segurança localmente.

[!TIP] Sessão expirada? Se seu agente receber erros de autenticação, basta pedir para ele executar o comando npx notebooklm-mcp-server refresh_auth. Ele abrirá automaticamente o navegador para você renovar a sessão sem sair do chat.

---

⚡ Início Rápido

🤖 Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

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

💻 Visual Studio Code

Como o VS Code ainda não suporta MCP nativamente, você deve usar uma extensão:

Opção A: Usando Cline (Recomendado)

1. Abra as Configurações do Cline no VS Code.
2. Role até a seção MCP Servers.
3. Clique em Adicionar Novo MCP Server.
4. Use a seguinte configuração:
   • Nome: notebooklm
   • Comando: npx -y notebooklm-mcp-server start

Opção B: Usando MCP Client

1. Instale a extensão da Marketplace.
2. Abra seu settings.json do VS Code.
3. Adicione o servidor em mcp.servers:

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

🌌 Antigravity

O Antigravity suporta MCP nativamente. Você pode adicionar o servidor editando seu arquivo de configuração global:

1. Localize seu mcp.json:

   • Windows: %APPDATA%\antigravity\mcp.json
   • macOS: ~/Library/Application Support/antigravity/mcp.json
   • Linux: ~/.config/antigravity/mcp.json

2. Adicione o servidor ao objeto mcpServers:

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

3. Reinicie o Antigravity: As novas ferramentas aparecerão na sua barra lateral imediatamente.

---

💎 Gemini CLI

Execute o seguinte comando no seu terminal para adicionar a skill do notebooklm:

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

---

🤖 Skill do Claude Code

Adicione instantaneamente ao Claude Code:

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

---

📖 Documentação

As seguintes ferramentas estão disponíveis através deste servidor MCP:

📒 Gerenciamento de Notebooks

Ferramenta	Descrição
notebook_list	Lista todos os notebooks da sua conta.
notebook_create	Cria um novo notebook com um título.
notebook_rename	Renomeia um notebook existente.
notebook_delete	Exclui um notebook (Aviso: Destrutivo).

🖇️ Gerenciamento de Fontes

Ferramenta	Descrição
notebook_add_url	Adiciona um site ou vídeo do YouTube como fonte.
notebook_add_text	Adiciona conteúdo de texto personalizado como fonte.
notebook_add_local_file	Envia um arquivo local PDF, Markdown ou Texto.
notebook_add_drive	Adiciona um arquivo do Google Drive (Docs, Slides, etc.).
source_delete	Remove uma fonte de um notebook.
source_sync	Sincroniza uma fonte do Drive para obter a versão mais recente.

🔍 Pesquisa e Consulta

Ferramenta	Descrição
notebook_query	Faz uma pergunta fundamentada a um notebook específico.
research_start	Inicia uma tarefa de pesquisa web/drive.
research_poll	Verifica o status e os resultados da pesquisa.
research_import	Importa resultados de pesquisa como fontes permanentes.

🎨 Studio e Geração

Ferramenta	Descrição
audio_overview_create	Gera uma Visão Geral em Áudio (podcast).
studio_poll	Verifica o status de artefatos de áudio/vídeo gerados.
mind_map_generate	Gera um JSON de Mapa Mental a partir de fontes.

⚙️ Sistema

Ferramenta	Descrição
refresh_auth	Interativo: Abre um navegador para renovar sua sessão do Google. Use se as ferramentas começarem a falhar.

---

🛠️ Desenvolvimento

Para contribuir ou compilar a partir do código-fonte:

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

🌐 Localização

Este projeto está disponível em vários idiomas:

• English (Fonte)
• Español
• Français
• Português
• Deutsch

Se você atualizar o README.md em inglês, certifique-se de que as traduções sejam atualizadas de acordo para manter a documentação sincronizada.

📄 Licença

Licença MIT. Desenvolvido com ❤️ por moodRobotics.