Repolode
suekou

suekou/mcp-notion-server

Servidor MCP que permite a agentes de IA buscar, leer, consultar y editar páginas y bases de datos de Notion mediante la API de Notion.

Estrellas
923
Forks
181
Issues abiertos
10
Último commit
hace 3 meses

¿Qué es?

Este servidor de Model Context Protocol conecta los espacios de trabajo de Notion con clientes compatibles con MCP, como Claude Desktop y Cursor. Está diseñado para la API de Notion 2026-03-11 y funciona con el modelo actual de bases de datos y fuentes de datos. Las respuestas son compactas e incluyen IDs de bloque estables para facilitar la edición.

El servidor ofrece herramientas para buscar y localizar páginas o fuentes de datos, leer el contenido de las páginas, inspeccionar esquemas de fuentes de datos y consultar o crear elementos con valores simples. Las herramientas de edición básicas permiten trabajar con párrafos, encabezados, listas, tareas, citas, avisos, bloques de código, separadores y añadir contenido en Markdown. También hay herramientas de la API de Notion sin procesar para operaciones avanzadas con bloques, páginas, bases de datos, comentarios y usuarios.

Para configurarlo, hay que crear una integración interna de Notion, concederle permisos de lectura, inserción o actualización, y compartir con ella las páginas o bases de datos correspondientes. El servidor se ejecuta mediante npx con la variable de entorno NOTION_API_TOKEN; además, hay MCP Apps opcionales que ofrecen Data Source Explorer y Page Workbench.

Funciones clave

  • 01Busca páginas y fuentes de datos mediante notion_find.
  • 02Lee páginas en formato compacto con IDs de bloque estables para editarlas.
  • 03Inspecciona los esquemas de las fuentes de datos antes de consultar o crear elementos.
  • 04Consulta y crea elementos en fuentes de datos usando valores simples.
  • 05Edita páginas con párrafos, encabezados, listas, tareas, bloques de código y contenido añadido en Markdown.
  • 06Ofrece herramientas de la API de Notion sin procesar para operaciones avanzadas con bloques, bases de datos, comentarios y usuarios.

Casos de uso

  • Permitir que un asistente de IA en Claude Desktop o Cursor lea y resuma notas de Notion.
  • Consultar una base de datos de Notion y añadirle registros desde el flujo de trabajo de un agente.
  • Añadir automáticamente contenido generado en Markdown a páginas de Notion.
  • Actualizar en lote bloques de páginas mediante un proceso de edición basado en IA.

Inicio rápido

  1. 1

    Crea una integración interna de Notion y copia su token

  2. 2

    Añade el servidor a la configuración de tu host MCP con NOTION_API_TOKEN configurado

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

    Reinicia el host MCP después de guardar la configuración

Antes de usarlo

  • Debes compartir explícitamente cada página o base de datos de Notion con la integración para que el servidor pueda acceder a ella.
  • Para el desarrollo, se requiere un token de integración de Notion y Node.js 22 o posterior.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mcp-notion-server?
Servidor MCP que permite a agentes de IA buscar, leer, consultar y editar páginas y bases de datos de Notion mediante la API de Notion. Este servidor de Model Context Protocol conecta los espacios de trabajo de Notion con clientes compatibles con MCP, como Claude Desktop y Cursor. Está diseñado para la API de Notion 2026-03-11 y funciona con el modelo actual de bases de datos y fuentes de datos. Las respuestas son compactas e incluyen IDs de bloque estables para facilitar la edición.
¿mcp-notion-server es gratuito? ¿Qué licencia tiene?
mcp-notion-server es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-notion-server sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de mcp-notion-server fue el 31 jul 2026.
¿Para qué puedo usar mcp-notion-server?
Permitir que un asistente de IA en Claude Desktop o Cursor lea y resuma notas de Notion. Consultar una base de datos de Notion y añadirle registros desde el flujo de trabajo de un agente. Añadir automáticamente contenido generado en Markdown a páginas de Notion. Actualizar en lote bloques de páginas mediante un proceso de edición basado en IA.
¿Cómo se instala mcp-notion-server?
Crea una integración interna de Notion y copia su token Añade el servidor a la configuración de tu host MCP con NOTION_API_TOKEN configurado: npx -y @suekou/mcp-notion-server Reinicia el host MCP después de guardar la configuración
¿Dónde consigo mcp-notion-server?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/suekou/mcp-notion-server

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados