Repolode
suekou

suekou/mcp-notion-server

Servidor MCP que permite a agentes de IA encontrar, ler, consultar e editar páginas e bancos de dados do Notion pela Notion API.

Estrelas
923
Forks
181
Issues abertas
10
Último commit
há 3 meses

O que é?

Este é um servidor do Model Context Protocol que conecta workspaces do Notion a clientes compatíveis com MCP, como Claude Desktop e Cursor. Ele usa a Notion API 2026-03-11 e é compatível com o modelo atual de bancos de dados e fontes de dados. As respostas são compactas e mantêm IDs de blocos estáveis para edição.

O servidor oferece ferramentas para pesquisar e localizar páginas ou fontes de dados, ler conteúdo de páginas, inspecionar esquemas de fontes de dados e consultar ou criar itens usando valores simples. As ferramentas básicas de edição abrangem parágrafos, títulos, listas, tarefas, citações, callouts, blocos de código, divisores e anexação de conteúdo em Markdown. Também há ferramentas da Notion API em baixo nível para operações avançadas com blocos, páginas, bancos de dados, comentários e usuários.

A configuração exige criar uma integração interna do Notion, conceder a ela permissões de leitura, inserção ou atualização e compartilhá-la com as páginas ou os bancos de dados desejados. O servidor é executado via npx com a variável de ambiente NOTION_API_TOKEN; opcionalmente, os MCP Apps oferecem um Data Source Explorer e um Page Workbench.

Recursos principais

  • 01Encontra páginas e fontes de dados por meio de buscas com notion_find.
  • 02Lê páginas em formato compacto, com IDs de blocos estáveis para edição.
  • 03Inspeciona esquemas de fontes de dados antes de consultar ou criar itens.
  • 04Consulta e cria itens em fontes de dados usando valores simples.
  • 05Edita páginas com parágrafos, títulos, listas, tarefas, blocos de código e anexação de conteúdo em Markdown.
  • 06Oferece ferramentas da Notion API em baixo nível para operações avançadas com blocos, bancos de dados, comentários e usuários.

Casos de uso

  • Permitir que um assistente de IA no Claude Desktop ou Cursor leia e resuma anotações do Notion.
  • Consultar e adicionar registros a um banco de dados do Notion em um fluxo de trabalho com agentes.
  • Anexar automaticamente conteúdo gerado em Markdown a páginas do Notion.
  • Atualizar blocos de páginas em lote com um processo de edição orientado por IA.

Início rápido

  1. 1

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

  2. 2

    Adicione o servidor à configuração do seu host MCP com NOTION_API_TOKEN definido

    npx -y @suekou/mcp-notion-server
  3. 3

    Reinicie o host MCP depois de salvar a configuração

Antes de usar

  • Cada página ou banco de dados do Notion precisa ser compartilhado explicitamente com a integração para que o servidor possa acessá-lo.
  • O desenvolvimento requer um token de integração do Notion e Node.js 22 ou mais recente.

Em coleções

Tópicos

Perguntas frequentes

O que é mcp-notion-server?
Servidor MCP que permite a agentes de IA encontrar, ler, consultar e editar páginas e bancos de dados do Notion pela Notion API. Este é um servidor do Model Context Protocol que conecta workspaces do Notion a clientes compatíveis com MCP, como Claude Desktop e Cursor. Ele usa a Notion API 2026-03-11 e é compatível com o modelo atual de bancos de dados e fontes de dados. As respostas são compactas e mantêm IDs de blocos estáveis para edição.
mcp-notion-server é gratuito? Qual é a licença?
mcp-notion-server é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-notion-server ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de mcp-notion-server foi em 31 de jul. de 2026.
Para que posso usar mcp-notion-server?
Permitir que um assistente de IA no Claude Desktop ou Cursor leia e resuma anotações do Notion. Consultar e adicionar registros a um banco de dados do Notion em um fluxo de trabalho com agentes. Anexar automaticamente conteúdo gerado em Markdown a páginas do Notion. Atualizar blocos de páginas em lote com um processo de edição orientado por IA.
Como instalar mcp-notion-server?
Crie uma integração interna do Notion e copie o token Adicione o servidor à configuração do seu host MCP com NOTION_API_TOKEN definido: npx -y @suekou/mcp-notion-server Reinicie o host MCP depois de salvar a configuração
Onde consigo mcp-notion-server?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/suekou/mcp-notion-server

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

Projetos relacionados