Notion MCP: como ligar o Notion ao Claude, ao Cursor, ao Codex e ao ChatGPT

Por Andrei Finogeev, fundador do Weft ·

O servidor MCP oficial do Notion está alojado em https://mcp.notion.com/mcp (Streamable HTTP, com alternativa SSE) e inicia sessão com OAuth; os espaços de trabalho Business e Enterprise também podem usar um token MCP. Funciona em todos os planos do Notion. Abra a biblioteca de conectores ou de plugins do seu assistente, pesquise Notion e inicie sessão — ou adicione o URL no Claude Code, no Cursor, no VS Code ou no Codex. O antigo servidor local open source já não tem manutenção.

Notion MCP num relance

URL do servidorhttps://mcp.notion.com/mcp — alternativa SSE em /sse
Início de sessãoOAuth; um bearer token MCP no Business e no Enterprise
Plano gratuitoSim — “Notion MCP works on every plan”
Limites de pedidos180 pedidos por minuto (600 no Business e no Enterprise); consultas a fontes de dados ~3 por segundo
EliminaçõesSim — páginas e bases de dados vão para o Trash
Planos pagosPlus 10 US$/membro por mês no anual (12 US$ no mensal); Business 20 US$ (24 US$)

“Não indicado” significa que Notion não o diz. Os preços são preços de tabela em dólares americanos por lugar; os impostos e os preços regionais variam.

Como configurar o Notion MCP em cada assistente

Claude (web e secretária)

Customize → Connectors (ou “+” → Connectors numa conversa), escolha o Notion no diretório e inicie sessão.

Claude Code

Adicione o servidor, depois execute /mcp no Claude Code e inicie sessão. O Notion também oferece um plugin para o Claude Code (makenotion/claude-code-notion-plugin).

claude mcp add --transport http notion https://mcp.notion.com/mcp

Cursor

Adicione o Notion a .cursor/mcp.json, ative-o e conclua o início de sessão.

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

VS Code (Copilot)

Adicione o servidor a .vscode/mcp.json com "type": "http", depois execute “MCP: List Servers” e inicie-o.

Codex

Adicione a ~/.codex/config.toml e depois inicie sessão.

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

# then: codex mcp login notion

ChatGPT

A documentação do Notion não dá passos para o ChatGPT nem lista de planos. A OpenAI oferece uma app do Notion no ChatGPT; não conseguimos confirmar nas páginas atuais da OpenAI o que ela pode escrever.

O que a sua IA pode fazer no Notion

  • Pesquisar e obter páginas; criar páginas (também a partir de modelos de bases de dados) e atualizar o seu conteúdo e propriedades.
  • Usar uma base de dados como lista de tarefas: criar linhas, atualizar as suas propriedades, consultar vistas guardadas e fontes de dados, criar vistas.
  • Criar bases de dados e fontes de dados; comentários e edições sugeridas; mover, duplicar, eliminar e restaurar páginas.
  • Carregar imagens e ficheiros até 20 MiB; eventos de calendário e notas de reuniões.

Limites a ter em conta

  • Só os membros do espaço de trabalho se podem ligar — os convidados não.
  • Os limites de pedidos aplicam-se a todas as chamadas de ferramentas: 180 por minuto, ou 600 no Business e no Enterprise.
  • As consultas ao estilo SQL só são ilimitadas no Business ou no Enterprise com Notion AI; a pesquisa nos conectores exige o mesmo.
  • As páginas criadas sem destino tornam-se páginas privadas.
  • Uma base de dados do Notion é uma tabela que molda como lista de tarefas; não existe um conceito incorporado de um agente assumir uma tarefa ou reportar progresso.

Notion ou Weft para trabalhar com IA?

Escolha o Notion se as suas tarefas vivem ao lado dos seus documentos e wiki e quer um único assistente para ambos. O seu servidor MCP é abrangente, alojado pelo Notion e gratuito em todos os planos.

Escolha o Weft se quer um quadro de tarefas conduzido pela sua IA, em vez de uma base de dados que tem de desenhar. O Weft é Scrumban pronto a usar — backlog, sprints e um limite para o trabalho concluído que aguarda a sua revisão — e as suas ferramentas são feitas para assistentes que fazem o trabalho: assumir uma tarefa, reportar progresso, fazer-lhe uma pergunta que espera na sua Caixa de entrada, registar a decisão. Funciona no ChatGPT em todos os planos, incluindo o Free.

Quadro do Weft num telemóvel, coluna Doing: três tarefas que um assistente de IA assumiu, cada uma marcada como IA
Os assistentes pegam na tarefa seguinte; cada cartão mostra quem está a trabalhar nela.
Uma tarefa do Weft criada por IA e concluída, com o resultado que o assistente registou: o que corrigiu e que 40 execuções de testes passaram
Quando um assistente termina, deixa um comprovativo: o que fez e como o verificou.

Configurar o Weft: Weft no ChatGPT · Weft no Claude · Weft no Claude Code · Weft no Cursor · Weft no Codex

Perguntas

Qual é o URL do servidor MCP do Notion?

https://mcp.notion.com/mcp. Use https://mcp.notion.com/sse apenas se o seu cliente não suportar Streamable HTTP.

O servidor MCP do Notion é gratuito?

Sim. O Notion diz que o Notion MCP funciona em todos os planos; algumas funcionalidades de pesquisa exigem o Business ou o Enterprise com Notion AI.

Devo usar o notion-mcp-server open source?

O Notion diz que o makenotion/notion-mcp-server já não tem manutenção ativa e recomenda o servidor alojado; chama ao local um último recurso.

A IA consegue gerir tarefas numa base de dados do Notion?

Sim. Através do servidor alojado, consegue criar linhas, atualizar as suas propriedades e consultar vistas guardadas, por isso uma base de dados funciona como lista de tarefas.

Fontes

Lido a 11 de novembro de 2026.

Outros guias de configuração MCP