Como integrar o Notion com o Claude. Três caminhos, passo a passo.
O caminho mais rápido leva dois minutos e não exige código. A maioria dos tutoriais ainda mostra uma configuração antiga, que não é mais o melhor ponto de partida. Veja o que usar hoje e o que fazer quando a conexão não funciona.
A forma mais rápida de integrar Notion com Claude é o conector do Notion: no Claude, abra Customize → Connectors, clique em +, escolha Notion, clique em Connect e aprove o acesso. Sem arquivo de configuração, sem token, sem terminal. O Claude poderá pesquisar, ler, criar e atualizar suas páginas do Notion. Mostramos os menus em inglês; se o app estiver em português, talvez você os veja traduzidos.
Tutoriais mais antigos costumam chamar o menu External Agents do Notion de conector para a sua conta do Claude e recomendar tokens de integração para o caminho manual. Nenhuma das duas coisas vale para a configuração atual. Os External Agents rodam dentro do Notion e não usam a sua conta do Claude, e o servidor MCP hospedado do Notion faz login com OAuth. Este guia já considera os dois pontos.
01Escolha seu caminho
Os três colocam o Claude para trabalhar com o seu conteúdo do Notion, mas são produtos diferentes. O certo depende de onde você quer trabalhar.
Conector do Notion
Você trabalha no Claude, na web ou no desktop. Usa a sua conta do Claude. Dois minutos, sem código.
MCP no Claude Code
Você trabalha no terminal ou em um editor. Um comando, depois um login no navegador.
Agente do Claude no Notion
Você trabalha dentro do Notion. Beta, apenas Business e Enterprise, cobrado em créditos do Notion.
02O conector do Notion
Este é o conector oficial, criado pelo Notion e marcado como verificado pela Anthropic no diretório do Claude. Os mesmos passos valem para a web e para o app desktop, e depois de conectado ele também aparece no celular.
Passo 1. No Claude, vá em Customize → Connectors e clique no + ao lado de Connectors. Você também pode começar por um chat: clique em +, passe o mouse sobre Connectors e escolha Manage connectors.
Passo 2. Encontre Notion na lista e clique em Connect.
Passo 3. Faça login no Notion na janela que abrir, escolha seu espaço de trabalho e aprove o acesso.
Passo 4. Em um chat, abra o menu +, passe o mouse sobre Connectors e confira se o Notion está ativado para aquela conversa.
Primeiro, um Owner precisa ativar o Notion em Organization settings → Connectors. Depois disso, cada pessoa ainda conecta a própria conta. Se você não encontra o Notion na lista, este é o motivo provável.
03Notion MCP no Claude Code
O Notion hospeda o próprio servidor MCP, então não há nada para instalar nem executar. Adicione-o pelo terminal:
claude mcp add --transport http notion https://mcp.notion.com/mcpDepois, dentro do Claude Code, execute /mcp, selecione Notion e conclua o login no navegador.
Esse comando vale apenas para o projeto atual. Adicione --scope user para usar o Notion em todos os seus projetos, ou --scope project para compartilhar a configuração com sua equipe por meio do .mcp.json.
O Notion também publica um plugin opcional que adiciona o mesmo servidor, além de skills e slash commands para tarefas comuns no Notion:
/plugin marketplace add makenotion/claude-code-notion-plugin
/plugin install notion-workspace-plugin@notion-plugin-marketplaceGuias que mandam criar um token de integração e compartilhar as páginas uma a uma descrevem o notion-mcp-server de código aberto. A documentação do Notion agora diz que ele não é mais mantido ativamente e o posiciona como último recurso para clientes que não conseguem acessar servidores remotos. Se um espaço de trabalho precisa de uma conexão sem login no navegador, proprietários nos planos Business e Enterprise podem criar um token MCP para o servidor hospedado.
04Agentes do Claude dentro do Notion
O Notion 3.6, lançado em 1º de julho de 2026, adicionou os External Agents, com Claude e Cursor como os dois primeiros. Este é um produto diferente do conector: o Claude trabalha dentro do seu espaço de trabalho como um colega a quem você pode atribuir tarefas ou mencionar.
Para configurar um, vá em Agents → New Agent → Claude na barra lateral do Notion, escolha um modelo ou comece do zero e depois defina os gatilhos e a programação. Antes de contar com isso, conheça as condições:
- Planos: apenas Business e Enterprise, em beta e com liberação gradual.
- Conta: não é preciso ter conta da Anthropic nem chave de API, e você não pode usar as suas.
- Custo: cada execução consome créditos do Notion. Tarefas mais longas custam mais.
- Limites: ele não pode navegar na web nem chamar outros agentes durante uma sessão.
- Enterprise: desativado por padrão. Um proprietário ativa em Settings → Notion AI → Agent → Manage external agents.
05O que o Claude pode ver e alterar
Esta é a parte que a maioria dos tutoriais pula. O conector e o MCP não funcionam página por página. O próprio Notion avisa que as ferramentas MCP agem com todas as suas permissões do Notion: tudo o que você consegue abrir, o Claude consegue acessar depois de conectado. Nada além disso, mas nada a menos também.
Ele também pode escrever. O Claude pode pesquisar e ler, criar e atualizar páginas, montar bancos de dados e visualizações, mover e duplicar páginas e adicionar comentários. Exclusões vão para a Lixeira e exigem confirmação, e as ferramentas destrutivas são marcadas para que os clientes possam perguntar a você antes.
Dois hábitos mantêm isso seguro. Peça um rascunho ou um resumo antes de pedir edições em massa, e mantenha o que for realmente sensível em um espaço de trabalho que você não conecta. Os agentes do Claude dentro do Notion funcionam de outro jeito: cada agente vê apenas o que é compartilhado com ele.
06Teste a conexão
Execute nesta ordem. Use o nome de uma página real do seu espaço de trabalho.
- Ele consegue ver? "Pesquise [nome da página] no meu Notion e resuma em três linhas."
- Ele consegue ler a estrutura? "Liste as propriedades do meu banco de dados [nome do banco de dados]."
- Ele consegue escrever? "Crie uma página privada chamada Teste do Claude com a data de hoje."
Se os três funcionarem, está pronto. Exclua a página de teste.
07Quando não funciona
O Notion não aparece na sua lista de conectores. Em Team ou Enterprise, um Owner ainda não o ativou.
O Claude ignora o Notion em um chat. Verifique a opção em + → Connectors para aquela conversa e depois cite o Notion no seu pedido.
O Claude não encontra uma página. Confirme que a sua conta consegue abri-la. Títulos de página vagos também atrapalham a busca, então informe o título exato ou cole o link da página.
O login trava ou falha. Feche a janela, remova o conector em Customize → Connectors e conecte de novo. No Claude Code, execute /mcp e faça login novamente.
Um recurso não está disponível. Algumas ferramentas exigem Business ou Enterprise com Notion AI, incluindo a busca em fontes conectadas e as edições sugeridas. Pergunte ao Claude o que o seu plano do Notion permite.
Você recebe um erro de rate limit. Cada chamada de ferramenta conta para os limites da API do Notion. Peça lotes menores, ou espere e tente de novo.