# NotebookLM no Claude (Claude Code e Claude Desktop)

Conecte o **Google NotebookLM** ao **Claude** usando MCP. Depois de instalar, você pode pedir ao Claude, em linguagem natural:

- *"Liste meus cadernos do NotebookLM"*
- *"Crie um caderno chamado 'Processo 0001234-56' e adicione este texto como fonte"*
- *"Pergunte ao caderno X quais são os pontos controvertidos"*
- *"Gere um podcast / slides / mapa mental / quiz a partir do caderno X"*

Os materiais (podcast, vídeo, slides, relatório etc.) são gerados em **português do Brasil**.

> Funciona no **Windows** e no **Mac**. Tempo estimado: 15 minutos.
> Não é preciso saber programar: basta copiar e colar os comandos.

---

## O que você vai precisar

- Uma conta Google com acesso ao [NotebookLM](https://notebooklm.google.com)
- O [Claude Desktop](https://claude.ai/download) instalado (já com o seu login feito)
- Conexão com a internet

---

## Passo 1 — Instalar o `uv`

O `uv` é o programa que instala o Python e as bibliotecas deste projeto automaticamente.

**Windows:** abra o **PowerShell** (menu Iniciar → digite *PowerShell* → Enter) e cole:

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

**Mac:** abra o **Terminal** (Cmd + Espaço → digite *Terminal* → Enter) e cole:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Quando terminar, **feche o PowerShell/Terminal e abra de novo** e confira:

```bash
uv --version
```

Deve aparecer algo como `uv 0.x.x`.

---

## Passo 2 — Baixar este projeto

1. Nesta página do GitHub, clique no botão verde **Code** → **Download ZIP**.
2. Descompacte o arquivo na sua pasta **Documentos**.
3. Renomeie a pasta para **`notebooklm-mcp`** (o GitHub costuma adicionar `-main` no final do nome).

Ao final, você deve ter:
- Windows: `C:\Users\SEU_USUARIO\Documents\notebooklm-mcp`
- Mac: `/Users/SEU_USUARIO/Documents/notebooklm-mcp`

> Se você usa `git`, pode clonar em vez de baixar o ZIP.

---

## Passo 3 — Instalar as dependências

No PowerShell (Windows) ou Terminal (Mac), entre na pasta do projeto:

**Windows:**
```powershell
cd $HOME\Documents\notebooklm-mcp
```

**Mac:**
```bash
cd ~/Documents/notebooklm-mcp
```

E instale:

```bash
uv sync
```

Na primeira vez demora um ou dois minutos. Se aparecer um erro de **certificado** (`invalid peer certificate` / `UnknownIssuer`), use este comando no lugar (veja o motivo em *Problemas comuns*):

```bash
uv sync --system-certs
```

---

## Passo 4 — Fazer login no Google

Ainda na pasta do projeto, rode:

```bash
uv run python login.py
```

1. Na primeira vez, o script baixa um navegador (Chromium, ~300 MB). Aguarde alguns minutos.
2. Uma janela do navegador vai abrir. **Entre na sua conta Google** (incluindo verificação em duas etapas, se houver).
3. **Não feche o navegador.** Quando a página do NotebookLM carregar, ele fecha sozinho.
4. No terminal deve aparecer:

```
LOGIN OK! 12 caderno(s) encontrado(s).
```

> Se a janela abrir atrás de outras, procure o ícone do Chromium na barra de tarefas (Windows) ou no Dock (Mac).

---

## Passo 5 — Conectar ao Claude

1. **Feche o Claude por completo:**
   - Windows: clique com o botão direito no ícone do Claude perto do relógio → **Sair**.
   - Mac: menu **Claude → Quit Claude** (ou Cmd + Q).
2. No PowerShell/Terminal, na pasta do projeto, rode:

```bash
uv run python configurar.py
```

Deve aparecer algo como:

```
OK  Claude Desktop: ...claude_desktop_config.json
OK  Claude Code: ...\.claude.json
```

3. Abra o Claude novamente.

> **Por que fechar o Claude?** O app aberto regrava o próprio arquivo de configuração e apaga o que o script acabou de adicionar.

---

## Passo 6 — Testar

**No Claude Desktop (aba de conversa):** peça

> Liste meus cadernos do NotebookLM

**No Claude Code:** abra uma sessão nova e peça o mesmo.

Na primeira vez o Claude pede permissão para usar a ferramenta — clique em **Permitir**.

Para conferir se o servidor está ligado:
- Claude Desktop: **Configurações → Desenvolvedor**: o `notebooklm` deve aparecer como *running*.
- Claude Code: digite `/mcp` e veja se `notebooklm` aparece como conectado.

---

## Ferramentas disponíveis

| Ferramenta | O que faz |
|---|---|
| `list_notebooks` | Lista seus cadernos |
| `create_notebook` | Cria um caderno |
| `add_source_url` | Adiciona site ou vídeo do YouTube como fonte |
| `add_source_text` | Adiciona um texto como fonte |
| `ask_notebook` | Faz perguntas respondidas com base nas fontes |
| `get_notebook_summary` | Resume o caderno |
| `generate_audio_overview` | Gera podcast (Resumo em Áudio) |
| `generate_video_overview` | Gera vídeo (Resumo em Vídeo) |
| `generate_slide_deck` | Gera apresentação de slides |
| `generate_mind_map` | Gera mapa mental |
| `generate_infographic` | Gera infográfico |
| `generate_quiz` | Gera teste |
| `generate_flashcards` | Gera cartões de estudo |
| `generate_summary_report` | Gera relatório (briefing) |
| `generate_data_table` | Gera tabela de dados |

Os materiais do "Estúdio" (podcast, vídeo, slides...) levam alguns minutos para ficar prontos e aparecem no painel **Estúdio** do NotebookLM.

> **Arquivos (PDF, Word):** o servidor aceita **texto** e **links**, não arquivos. Um bom fluxo é pedir ao Claude Code para extrair o texto do PDF e enviá-lo ao caderno com `add_source_text`.

---

## Problemas comuns

| Sintoma | Causa | Solução |
|---|---|---|
| Claude diz "login ausente ou expirado", ou o `notebooklm` aparece como falho/"Connection closed" | O login do Google expirou (acontece de tempos em tempos) | Rode de novo `uv run python login.py` e reinicie o Claude |
| `invalid peer certificate`, `CERTIFICATE_VERIFY_FAILED` ou `OPENSSL_Applink` | Antivírus (Avast, AVG, Kaspersky...) inspecionando conexões seguras | Use `uv sync --system-certs`. Os scripts deste projeto já corrigem isso para o Python |
| O `notebooklm` some da configuração do Claude Desktop | O Claude estava aberto quando você rodou `configurar.py` | Feche o Claude **por completo** e rode `configurar.py` de novo |
| `uv` não é reconhecido como comando | O terminal foi aberto antes da instalação do `uv` | Feche e abra o PowerShell/Terminal |
| O navegador fechou e apareceu "fechado antes de terminar" | A janela foi fechada manualmente | Rode `login.py` de novo e deixe o navegador fechar sozinho |
| Mudou a pasta do projeto de lugar | A configuração aponta para o caminho antigo | Rode `uv run python configurar.py` de novo (com o Claude fechado) |

Para trocar o idioma dos materiais gerados, defina a variável de ambiente `NOTEBOOKLM_LANG` (ex.: `en`, `es`, `pt_PT`).

---

## Avisos importantes

- Este projeto usa uma **interface não oficial** do NotebookLM (biblioteca [notebooklm-py](https://pypi.org/project/notebooklm-py/)). Se o Google mudar algo, pode parar de funcionar até a biblioteca ser atualizada.
- O arquivo de login fica em `~/.notebooklm/` no seu computador e dá acesso à sua conta Google. **Nunca compartilhe essa pasta** nem a envie para o GitHub.
- Cuidado com dados sigilosos: o conteúdo enviado ao NotebookLM fica armazenado no Google, sujeito aos termos de uso do serviço.

---

## Créditos

Adaptado de [alfredang/notebooklm-mcp](https://github.com/alfredang/notebooklm-mcp) (licença MIT), com:
- compatibilidade com a biblioteca `notebooklm-py` 0.8 (novo domínio `notebook.google.com`);
- login que funciona no Windows e detecta sozinho o fim do login;
- correções para antivírus que inspecionam HTTPS;
- configurador automático do Claude Desktop (inclusive versão da Microsoft Store) e do Claude Code;
- materiais gerados em português.