Repolode
Enviar
makenotion

makenotion/notion-mcp-server

Servidor MCP autoalojado que permite a los asistentes de IA leer y editar espacios de trabajo de Notion mediante la API de Notion; Notion Remote MCP alojado ya lo ha reemplazado.

Alternativa open source a:Notion AI

Ver en GitHub
Estrellas
4,671
Forks
638
Issues abiertos
202
Último commit
hace 30 días

¿Qué es?

Este proyecto es un servidor MCP (Model Context Protocol) que envuelve la API de Notion y expone operaciones de Notion como herramientas que pueden invocar clientes de IA como Claude Desktop, Cursor y Zed. Entre ellas se incluyen buscar, leer y crear páginas, consultar bases de datos y fuentes de datos, y añadir comentarios. Se ejecuta localmente mediante stdio de forma predeterminada o como servidor Streamable HTTP con autenticación mediante bearer token. El acceso se controla con un token de integración interna de Notion, y solo son visibles las páginas que se hayan conectado explícitamente a esa integración.

La versión 2.0.0 pasa a la versión 2025-09-03 de la API de Notion, en la que las fuentes de datos sustituyen a las bases de datos como abstracción principal, y añade dos herramientas para leer y editar el contenido de las páginas en Markdown. El equipo de Notion MCP indica que este repositorio ya no se mantiene activamente y recomienda usar su Notion MCP remoto alojado, que incluye búsqueda semántica y OAuth. Para configurar esta versión, sigue siendo necesario crear una integración, compartir páginas con ella y editar la configuración JSON del cliente.

El servidor se puede ejecutar mediante npx o Docker, o compilar desde el código fuente con npm. También incluye un modo opcional de transferencia de tokens para que una sola implementación pueda servir a varias integraciones de Notion.

Funciones clave

  • 01Expone operaciones de la API de Notion como herramientas MCP para clientes de IA.
  • 02Admite los transportes stdio y Streamable HTTP.
  • 03En la versión 2.0.0, lee y edita el contenido de las páginas en Markdown.
  • 04Funciona con fuentes de datos, incluida su creación, actualización y consulta.
  • 05Acepta un token de integración de Notion mediante NOTION_TOKEN o OPENAPI_MCP_HEADERS.
  • 06Ofrece la opción de transferir un token por solicitud para admitir varias integraciones.

Casos de uso

  • Permitir que un asistente de IA busque páginas en un espacio de trabajo de Notion y las resuma.
  • Automatizar la creación de páginas o la publicación de comentarios a partir de instrucciones en lenguaje natural en un editor.
  • Crear un puente autoalojado entre Notion y un agente de IA interno.
  • Ejecutar una integración de solo lectura para limitar lo que puede modificar un cliente de IA.

Inicio rápido

  1. 1

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

  2. 2

    Conecta a la integración las páginas que quieras usar

  3. 3

    Añade la configuración de MCP con npx a tu cliente usando NOTION_TOKEN

    npx -y @notionhq/notion-mcp-server

Antes de usarlo

  • Notion recomienda usar en su lugar Remote Notion MCP, su versión alojada, y este repositorio ya no se mantiene ni recibe soporte de forma activa.
  • Los issues y las solicitudes de cambios no se supervisan activamente y el proyecto podría dejar de estar disponible.
  • La búsqueda solo funciona por palabras clave y las herramientas para el contenido de las páginas son más limitadas que en la versión alojada.
  • Es necesario configurar manualmente el token de la integración y compartir las páginas.

Temas

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

Preguntas frecuentes

¿Qué es notion-mcp-server?
Servidor MCP autoalojado que permite a los asistentes de IA leer y editar espacios de trabajo de Notion mediante la API de Notion; Notion Remote MCP alojado ya lo ha reemplazado. Este proyecto es un servidor MCP (Model Context Protocol) que envuelve la API de Notion y expone operaciones de Notion como herramientas que pueden invocar clientes de IA como Claude Desktop, Cursor y Zed. Entre ellas se incluyen buscar, leer y crear páginas, consultar bases de datos y fuentes de datos, y añadir comentarios. Se ejecuta localmente mediante stdio de forma predeterminada o como servidor Streamable HTTP con autenticación mediante bearer token. El acceso se controla con un token de integración interna de Notion, y solo son visibles las páginas que se hayan conectado explícitamente a esa integración.
¿notion-mcp-server es gratuito? ¿Qué licencia tiene?
notion-mcp-server es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿notion-mcp-server sigue mantenido?
Mantenimiento activo. El último commit de notion-mcp-server fue el 20 sept 2026.
¿Para qué puedo usar notion-mcp-server?
Permitir que un asistente de IA busque páginas en un espacio de trabajo de Notion y las resuma. Automatizar la creación de páginas o la publicación de comentarios a partir de instrucciones en lenguaje natural en un editor. Crear un puente autoalojado entre Notion y un agente de IA interno. Ejecutar una integración de solo lectura para limitar lo que puede modificar un cliente de IA.
¿Cómo se instala notion-mcp-server?
Crea una integración interna en Notion y copia su token Conecta a la integración las páginas que quieras usar Añade la configuración de MCP con npx a tu cliente usando NOTION_TOKEN: npx -y @notionhq/notion-mcp-server
¿Dónde consigo notion-mcp-server?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/makenotion/notion-mcp-server

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

Proyectos relacionados