Repolode
Enviar
makenotion

makenotion/notion-mcp-server

Servidor MCP auto-hospedado que permite a assistentes de IA ler e editar workspaces do Notion pela Notion API; foi substituído pelo Remote MCP hospedado do Notion.

Alternativa open source a:Notion AI

Ver no GitHub
Estrelas
4,671
Forks
638
Issues abertas
202
Último commit
há 30 dias

O que é?

Este projeto é um servidor MCP (Model Context Protocol) que envolve a Notion API e expõe operações do Notion — como pesquisar, ler e criar páginas, consultar databases e data sources e adicionar comentários — como ferramentas que clientes de IA, como Claude Desktop, Cursor e Zed, podem chamar. Por padrão, ele roda localmente via stdio ou como servidor Streamable HTTP com autenticação por bearer token. O acesso é controlado por um token de integração interna do Notion, e somente as páginas explicitamente compartilhadas com essa integração ficam visíveis.

A versão 2.0.0 migra para a versão 2025-09-03 da Notion API, na qual data sources substituem databases como abstração principal, e adiciona duas ferramentas para ler e editar o conteúdo de páginas em Markdown. A equipe do Notion MCP informa que este repositório não recebe mais manutenção ativa e recomenda o Remote Notion MCP hospedado, que oferece busca semântica e OAuth. A configuração desta versão ainda exige criar uma integração, compartilhá-la com as páginas e editar um arquivo de configuração JSON do cliente.

O servidor pode ser executado via npx ou Docker, ou compilado a partir do código-fonte com npm. Ele também inclui um modo opcional de repasse de token, para que uma única implantação atenda a várias integrações do Notion.

Recursos principais

  • 01Expõe operações da Notion API como ferramentas MCP para clientes de IA.
  • 02Oferece suporte aos transportes stdio e Streamable HTTP.
  • 03Lê e edita o conteúdo de páginas em Markdown na versão 2.0.0.
  • 04Trabalha com data sources, incluindo criação, atualização e consulta.
  • 05Aceita um token de integração do Notion via NOTION_TOKEN ou OPENAPI_MCP_HEADERS.
  • 06Oferece repasse opcional de token por solicitação para várias integrações.

Casos de uso

  • Permitir que um assistente de IA pesquise e resuma páginas em um workspace do Notion.
  • Automatizar a criação de páginas ou a inclusão de comentários com instruções em linguagem natural em um editor.
  • Criar uma ponte auto-hospedada entre o Notion e um agente de IA interno.
  • Executar uma integração somente leitura para limitar o que um cliente de IA pode alterar.

Início rápido

  1. 1

    Crie uma integração interna no Notion e copie o token

  2. 2

    Conecte à integração as páginas que você quer usar

  3. 3

    Adicione a configuração de MCP com npx ao seu cliente usando NOTION_TOKEN

    npx -y @notionhq/notion-mcp-server

Antes de usar

  • O Notion recomenda usar o Remote Notion MCP hospedado, e este repositório não recebe mais manutenção nem suporte ativo.
  • Issues e pull requests não são monitorados ativamente, e o projeto pode ser encerrado.
  • A busca é apenas por palavras-chave, e as ferramentas de conteúdo das páginas são limitadas em comparação com a versão hospedada.
  • É necessário configurar manualmente o token da integração e compartilhar as páginas.

Tópicos

#mcp#notion#notion-api#ai-agents#typescript#llm-tools#self-hosted

Perguntas frequentes

O que é notion-mcp-server?
Servidor MCP auto-hospedado que permite a assistentes de IA ler e editar workspaces do Notion pela Notion API; foi substituído pelo Remote MCP hospedado do Notion. Este projeto é um servidor MCP (Model Context Protocol) que envolve a Notion API e expõe operações do Notion — como pesquisar, ler e criar páginas, consultar databases e data sources e adicionar comentários — como ferramentas que clientes de IA, como Claude Desktop, Cursor e Zed, podem chamar. Por padrão, ele roda localmente via stdio ou como servidor Streamable HTTP com autenticação por bearer token. O acesso é controlado por um token de integração interna do Notion, e somente as páginas explicitamente compartilhadas com essa integração ficam visíveis.
notion-mcp-server é gratuito? Qual é a licença?
notion-mcp-server é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
notion-mcp-server ainda é mantido?
Manutenção ativa. O último commit de notion-mcp-server foi em 20 de set. de 2026.
Para que posso usar notion-mcp-server?
Permitir que um assistente de IA pesquise e resuma páginas em um workspace do Notion. Automatizar a criação de páginas ou a inclusão de comentários com instruções em linguagem natural em um editor. Criar uma ponte auto-hospedada entre o Notion e um agente de IA interno. Executar uma integração somente leitura para limitar o que um cliente de IA pode alterar.
Como instalar notion-mcp-server?
Crie uma integração interna no Notion e copie o token Conecte à integração as páginas que você quer usar Adicione a configuração de MCP com npx ao seu cliente usando NOTION_TOKEN: npx -y @notionhq/notion-mcp-server
Onde consigo notion-mcp-server?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/makenotion/notion-mcp-server

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados