Notion MCP: como conectar o Notion ao Claude, ao Cursor, ao Codex e ao ChatGPT
Por Andrei Finogeev, fundador do Weft ·
O servidor MCP oficial do Notion fica hospedado em https://mcp.notion.com/mcp (Streamable HTTP, com fallback SSE) e o login é com OAuth; workspaces Business e Enterprise também podem usar um token MCP. Ele funciona em todos os planos do Notion. Abra a biblioteca de conectores ou plugins do seu assistente, procure Notion e entre — ou adicione a URL no Claude Code, no Cursor, no VS Code ou no Codex. O antigo servidor local open source não tem mais manutenção.
Notion MCP em resumo
| URL do servidor | https://mcp.notion.com/mcp — fallback SSE em /sse |
|---|---|
| Login | OAuth; um bearer token MCP no Business e no Enterprise |
| Plano gratuito | Sim — “Notion MCP works on every plan” |
| Limites de requisições | 180 requisições por minuto (600 no Business e no Enterprise); consultas a fontes de dados ~3 por segundo |
| Exclusões | Sim — páginas e bancos de dados vão para a lixeira |
| Planos pagos | Plus US$ 10/membro por mês no anual (US$ 12 no mensal); Business US$ 20 (US$ 24) |
“Não informado” significa que Notion não diz. Os preços são de tabela, em dólares americanos, por assento; impostos e preços regionais variam.
Como configurar o Notion MCP em cada assistente
Claude (web e desktop)
Customize → Connectors (ou “+” → Connectors em um chat), escolha o Notion no diretório e entre.
Claude Code
Adicione o servidor, depois rode /mcp no Claude Code e entre. 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/mcpCursor
Adicione o Notion em .cursor/mcp.json, ative-o e conclua o login.
{
"mcpServers": {
"notion": { "url": "https://mcp.notion.com/mcp" }
}
}VS Code (Copilot)
Adicione o servidor em .vscode/mcp.json com "type": "http", depois rode “MCP: List Servers” e inicie-o.
Codex
Adicione em ~/.codex/config.toml e depois faça login.
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
# then: codex mcp login notionChatGPT
A documentação do Notion não traz passos nem lista de planos para o ChatGPT. A OpenAI oferece um app do Notion no ChatGPT; não conseguimos confirmar nas páginas atuais da OpenAI o que ele pode escrever.
O que a sua IA pode fazer no Notion
- Buscar e abrir páginas; criar páginas (também a partir de modelos de banco de dados) e atualizar o conteúdo e as propriedades delas.
- Usar um banco de dados como lista de tarefas: criar linhas, atualizar as propriedades delas, consultar visualizações salvas e fontes de dados, criar visualizações.
- Criar bancos de dados e fontes de dados; comentários e sugestões de edição; mover, duplicar, excluir e restaurar páginas.
- Enviar imagens e arquivos de até 20 MiB; eventos de calendário e notas de reunião.
Limites que vale conhecer
- Só membros do workspace podem se conectar — convidados não.
- Os limites de requisições valem para toda chamada de ferramenta: 180 por minuto, ou 600 no Business e no Enterprise.
- Consultas no estilo SQL são ilimitadas só no Business ou no Enterprise com Notion AI; a busca em conectores exige o mesmo.
- Páginas criadas sem destino viram páginas privadas.
- Um banco de dados do Notion é uma tabela que você molda como lista de tarefas; não existe um conceito embutido de agente fazendo o claim de uma tarefa ou relatando o progresso.
Notion ou Weft para trabalhar com IA?
Escolha o Notion se as suas tarefas ficam ao lado dos seus docs e da sua wiki e você quer um assistente que alcance os dois. O servidor MCP dele é amplo, hospedado pelo Notion e grátis em todos os planos.
Escolha o Weft se você quer um quadro de tarefas que a sua IA toca, e não um banco de dados que você precisa desenhar. O Weft é Scrumban pronto — backlog, sprints e um limite de quanto trabalho concluído fica esperando sua revisão — e as ferramentas dele são feitas para assistentes que fazem o trabalho: fazer o claim de uma tarefa, relatar o progresso, fazer a você uma pergunta que espera na sua Caixa de entrada, registrar a decisão. Ele funciona no ChatGPT em todos os planos, inclusive o Free.
Configurando o Weft: Weft no ChatGPT · Weft no Claude · Weft no Claude Code · Weft no Cursor · Weft no Codex
Perguntas
Qual é a URL do servidor MCP do Notion?
https://mcp.notion.com/mcp. Use https://mcp.notion.com/sse só se o seu cliente não suportar Streamable HTTP.
O servidor MCP do Notion é grátis?
Sim. O Notion diz que o Notion MCP funciona em todos os planos; alguns recursos de busca exigem Business ou Enterprise com Notion AI.
Devo usar o notion-mcp-server open source?
O Notion diz que o makenotion/notion-mcp-server não tem mais manutenção ativa e recomenda o servidor hospedado; ele chama o servidor local de último recurso.
A IA consegue gerenciar tarefas em um banco de dados do Notion?
Sim. Pelo servidor hospedado, ela pode criar linhas, atualizar as propriedades delas e consultar visualizações salvas, então um banco de dados funciona como lista de tarefas.
Fontes
Lido em 11 de novembro de 2026.