O que é Notion MCP?
O Notion MCP é um servidor remoto hospedado pelo Notion em https://mcp.notion.com/mcp (um endpoint SSE em /sse ainda é oferecido). Você adiciona a URL a um cliente como Claude Code, Cursor ou Codex e faz login com OAuth, e o cliente passa a poder ler e alterar apenas o que você já acessa no Notion. Ele está disponível em todos os planos.
A lista de ferramentas é longa, mais de 50 na página de ferramentas suportadas. notion-search e notion-fetch encontram e leem conteúdo; notion-create-pages, notion-update-page, notion-move-pages e notion-duplicate-page o editam; notion-create-database, notion-create-view e notion-query-data-sources trabalham com bancos de dados, incluindo consultas no estilo SQL. Há também ferramentas para comentários, arquivos, usuários, calendários, Notion Skills, memórias de agentes e sessões de Custom Agent, e notion-connector-search para Slack, Google Drive, GitHub e Jira nos planos com Notion AI.
O servidor de código aberto mais antigo (@notionhq/notion-mcp-server, rodado com um token de integração) ainda funciona, na v2.1.0 de janeiro de 2026, mas seu README diz que ele não é mais mantido ativamente e que o Notion pode descontinuar o repositório.
Como instalar Notion MCP
https://mcp.notion.com/mcpNotion MCP vale a pena?
O servidor hospedado é onde o Notion concentrou seu esforço, e isso aparece nos detalhes. O acesso segue as permissões de cada usuário, então não há integração com a qual compartilhar páginas à mão, e as exclusões são tratadas com um cuidado incomum: notion-delete-pages move no máximo 20 páginas para a Lixeira, recusa-se a agir a menos que a chamada defina user_confirmed e é marcada como destrutiva, para que clientes que respeitam anotações perguntem antes. notion-restore-pages pode trazê-las de volta.
As restrições por plano decidem a qualidade da experiência. No Business e no Enterprise com Notion AI, a busca alcança Slack, Google Drive, GitHub e Jira, o SQL em várias fontes de dados é ilimitado e os filtros por editor, data ou vários teamspaces funcionam. Os outros planos têm busca por palavra-chave, uma fonte de dados por vez contra uma cota compartilhada do workspace cujo tamanho não é publicado, e chamadas que descartam silenciosamente filtros não suportados e devolvem um aviso. Os agentes precisam ler esses avisos, ou vão tratar resultados mais amplos como precisos.
Os limites de taxa são generosos para uso interativo e apertados para tarefas em massa. O Notion dá a cada conexão 180 requisições por minuto na maioria dos planos e 600 no Business e no Enterprise, as consultas a fontes de dados ficam em cerca de três por segundo, e algumas ferramentas MCP têm seus próprios limites curtos. Um agente migrando alguns milhares de linhas vai receber erros 429 e precisa respeitar o Retry-After.
A governança é mais fraca que a da Atlassian. Os owners do workspace podem ver os clientes conectados e a Admin API pode listar e revogar conexões, mas restringir quais clientes os membros podem conectar é exclusivo do Enterprise, e a central de ajuda do Notion diz que a visibilidade de ferramentas por usuário ainda não está disponível. Remover um app da lista de permissões bloqueia suas chamadas, mas não revoga os tokens que ele já tem.
Onde ele se destaca
Um engenheiro que mantém especificações e ADRs no Notion e programa no Claude Code
Trazer a especificação atual para a sessão de programação e atualizar seu status quando o trabalho for entregue
notion-fetch lê a página como Markdown e notion-update-page altera as propriedades. Não custa nada a mais em nenhum plano, e um punhado de chamadas por tarefa fica muito abaixo de 180 requisições por minuto.
Um líder de product ops que mantém um banco de pedidos de funcionalidades com 2.000 linhas
Fazer um agente agrupar e etiquetar os novos pedidos toda semana
notion-query-data-sources puxa as linhas e notion-update-page as etiqueta. No Business e no Enterprise com Notion AI, o SQL é ilimitado; no Plus, ele consome uma cota compartilhada e não publicada, e as atualizações em massa precisam ficar abaixo do limite de taxa.
Um administrador de TI em uma empresa de 300 pessoas no Notion Enterprise
Permitir Claude e ChatGPT, mas bloquear clientes MCP não avaliados
Defina os apps de IA como "Only approved list" em Connections; as conexões existentes são adicionadas automaticamente. Use a Admin API para listar e revogar conexões, e aceite que o uso de ferramentas por usuário ainda não é visível.
Antes de decidir
- Configuração
- Adicione https://mcp.notion.com/mcp ao Claude Code, Cursor, Codex ou outro cliente e conclua o OAuth no navegador; a primeira chamada de ferramenta sai em uns dois minutos. Clientes da Okta podem usar a autorização gerenciada pela empresa para que os membros não precisem aprovar cada cliente.
- Integrações
- Mais de 50 ferramentas: leitura (search, fetch, get-comments, query-data-sources), escrita (create-pages, update-page, move-pages, create-view, create-comment) e destrutivas (delete-pages, delete-databases, ambas condicionadas a confirmação). Conexões de propriedade do administrador podem expor um subconjunto escolhido de 24 ferramentas.
- Dados e privacidade
- O servidor hospedado lê e escreve tudo o que o usuário logado pode, e o Notion avisa que conteúdo de páginas, comentários e resultados de apps conectados podem trazer instruções de injeção de prompt que levem um cliente a vazar ou alterar dados. Não há alertas de segurança publicados no GitHub para o servidor de código aberto.
- Custo em escala
- Sem cobrança pelo servidor. O custo é o plano: busca completa e SQL ilimitado exigem o Business a $20 por membro por mês no plano anual, então 50 pessoas custam $12,000 por ano. A página de ajuda sobre créditos do Notion diz que o uso cotidiano de apps conectados e da API não consome créditos, só limites de taxa; rodar um agente por eles consome créditos do Notion.
- Limites
- 180 requisições por minuto por conexão no Free e no Plus, 600 no Business e no Enterprise, cerca de três consultas a fontes de dados por segundo, além de limites por ferramenta; páginas privadas de nível superior não podem ser restauradas via MCP.
O que é bom
- Login com OAuth; o acesso segue as permissões de cada usuário no Notion
- Mais de 50 ferramentas, incluindo visões de bancos de dados e consultas no estilo SQL
- Exclusões vão para a Lixeira, exigem user_confirmed e podem ser restauradas
- Disponível em todos os planos do Notion
O que não é
- Busca em apps conectados e SQL em várias fontes exigem Business ou Enterprise com Notion AI
- Listas de clientes permitidos só no Enterprise; ainda sem visibilidade de ferramentas por usuário
- 180 requisições por minuto por conexão abaixo do Business
- O servidor de código aberto auto-hospedado não é mantido
Ideal para
Equipes que mantêm documentação, wikis e bancos de dados de projetos no Notion e querem um assistente para lê-los e atualizá-los.
Alternativas ao Notion MCP
Notion MCP: perguntas frequentes
- Notion MCP vale a pena?
- O Notion investiu trabalho de verdade no seu servidor hospedado, e o resultado é uma interface de agente competente para um workspace, com as ferramentas úteis de busca e consulta reservadas aos planos Business. Damos nota 4.5 de 5.
- Quanto custa Notion MCP?
- Gratuito em todos os planos. Busca em apps conectados, consultas SQL ilimitadas e filtros avançados de busca exigem Business ($20/membro/mês no plano anual) ou Enterprise.
- Quais são as desvantagens de Notion MCP?
- Busca em apps conectados e SQL em várias fontes exigem Business ou Enterprise com Notion AI; listas de clientes permitidos só no Enterprise; ainda sem visibilidade de ferramentas por usuário; 180 requisições por minuto por conexão abaixo do Business; o servidor de código aberto auto-hospedado não é mantido.
- Para quem Notion MCP é indicado?
- Equipes que mantêm documentação, wikis e bancos de dados de projetos no Notion e querem um assistente para lê-los e atualizá-los.
- Quanto custa Notion MCP para uma equipe ou em produção?
- Sem cobrança pelo servidor. O custo é o plano: busca completa e SQL ilimitado exigem o Business a $20 por membro por mês no plano anual, então 50 pessoas custam $12,000 por ano. A página de ajuda sobre créditos do Notion diz que o uso cotidiano de apps conectados e da API não consome créditos, só limites de taxa; rodar um agente por eles consome créditos do Notion.
- Notion MCP é seguro para dados da empresa?
- O servidor hospedado lê e escreve tudo o que o usuário logado pode, e o Notion avisa que conteúdo de páginas, comentários e resultados de apps conectados podem trazer instruções de injeção de prompt que levem um cliente a vazar ou alterar dados. Não há alertas de segurança publicados no GitHub para o servidor de código aberto.
- Quais são as melhores alternativas ao Notion MCP?
- As alternativas mais próximas que analisamos são Atlassian Rovo MCP Server, Google Workspace MCP servers e Linear MCP.
Respostas verificadas em 26 de out. de 2026.