Notion MCP
Conecta un cliente MCP con tu espacio de Notion para buscar, leer y editar páginas mediante el servidor remoto oficial y autorización de usuario.
Fuente: Notion MCP (documentación oficial) · Oficial · Mantiene Notion · Ver original en developers.notion.com
Ficha técnica
- Organización
- Notion (se abre en una pestaña nueva)
- Transporte
- Streamable HTTP; alternativa SSE
- Clientes compatibles
- Claude Code
- Cursor
- Codex
Qué es y qué expone
Notion MCP es el servidor remoto oficial que conecta un cliente compatible con el contenido de un espacio de trabajo de Notion. Permite consultar información y ejecutar acciones sobre páginas y bases de datos desde el cliente. La documentación menciona Claude Code, Cursor y Codex entre los clientes compatibles: la experiencia de conexión cambia según la aplicación, pero el destino es el servicio alojado por Notion.
El acceso se autoriza con la cuenta del usuario. El servidor puede leer y actualizar el contenido al que esa cuenta ya tiene acceso. Por tanto, la conexión no convierte una página privada en pública ni sustituye la organización de permisos del espacio de trabajo. Su función es exponer operaciones a un cliente, para que este pueda utilizarlas durante una tarea.
Conviene distinguir este servicio de la versión abierta anterior. Estado comprobado el 2026-10-25: el paquete notion-mcp-server ya no recibe mantenimiento activo. La ficha se centra en el servidor remoto que Notion mantiene y aloja, que no requiere desplegar ese paquete por cuenta propia.
Qué problema resuelve
Una tarea con documentación suele combinar varias operaciones: encontrar la página correcta, leer su contenido y trasladar el resultado a una página nueva o a unas propiedades. Notion MCP expone herramientas para encadenar esas operaciones desde el cliente. La documentación da precisamente ese recorrido como ejemplo: buscar páginas, crear una página a partir de los resultados y actualizar propiedades.
La búsqueda no sustituye a la lectura. El servidor distingue la localización de coincidencias de la recuperación del contenido, y pide recuperar las coincidencias importantes antes de apoyarse en ellas. Esa separación ayuda a entender qué recibe el cliente en cada momento: primero una selección de resultados, después los datos que debe examinar para completar la tarea.
El alcance de cada búsqueda también importa. notion-search consulta páginas y bases de datos de Notion; la búsqueda de fuentes conectadas se expone por separado. No debe darse por hecho que una consulta del espacio de trabajo haya revisado también las conversaciones o los documentos de otros servicios.
Cómo funciona
El recorrido tiene un cliente, un servidor remoto y la API de Notion. El cliente solicita una operación al servidor MCP y este utiliza la API para acceder al contenido permitido. El usuario completa la autorización antes de usar la conexión. No hace falta instalar el antiguo servidor abierto para seguir el flujo remoto documentado.
La documentación recomienda Streamable HTTP. Mantiene una alternativa SSE para clientes que no admiten ese transporte. La configuración de ejemplo apunta al endpoint remoto y el cliente gestiona después la autenticación. Copiar la configuración no equivale a haber autorizado el espacio: sigue siendo necesario completar el flujo que presenta la aplicación.
Antes de decidir qué operación ejecutar, el cliente puede consultar notion-get-tool-access. Esta herramienta informa de disponibilidad y parámetros restringidos. Las herramientas aplican sus propios límites al ejecutarse: la consulta de acceso no concede permisos nuevos ni cambia el plan del espacio. Disponibilidad comprobada el 2026-10-25.
Del cliente al contenido
Leer el diagrama como texto
- Cliente MCP
- Notion MCP
- API de Notion
Conexiones
- Cliente MCP → Notion MCP
- Notion MCP → API de Notion
Herramientas expuestas
| Herramienta | Qué hace |
|---|---|
notion-search | Busca páginas y bases de datos del espacio. |
notion-fetch | Recupera contenido por su URL o identificador. |
notion-create-pages | Crea páginas con propiedades y contenido. |
notion-get-tool-access | Informa de las opciones y restricciones del acceso. |
Configuración
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}Ejemplo de uso
Ejemplo de KIRELEN (no oficial): quieres reunir la documentación de un proyecto en una página de trabajo. El cliente puede empezar con una búsqueda específica del nombre del proyecto, recuperar las coincidencias relevantes y preparar una nueva página con el contenido que se haya autorizado a reutilizar. El ejemplo ilustra la combinación de búsqueda, lectura y creación documentada por Notion; no es una ejecución realizada sobre un espacio real.
Es importante revisar las páginas recuperadas antes de aceptar el resultado. Una coincidencia por nombre no demuestra que sea la documentación vigente ni que contenga todas las decisiones del proyecto. La herramienta de recuperación permite examinar la página, en lugar de redactar a partir de un resultado de búsqueda aislado.
Antes de escribir, el cliente debe mostrar el destino y la acción propuesta para su revisión. La confirmación de cambios recomendada por Notion permite comprobar si se va a crear una página o modificar contenido existente. El flujo mantiene separadas la lectura de fuentes y la acción que escribe el resultado.
Seguridad y límites
Notion recomienda conectar únicamente clientes de confianza y verificar tanto el marketplace de procedencia como la dirección del servidor. El cliente conectado accede al contenido que el usuario puede consultar. Esto exige revisar sus permisos y considerar dónde procesa la información: el cliente puede enviar el contenido devuelto a sistemas externos a Notion.
El contenido leído se trata como datos no fiables. Una página puede incluir instrucciones que intenten alterar el comportamiento del cliente; Notion describe ese riesgo como inyección de instrucciones. Por eso pide revisar las acciones propuestas y el intercambio de información antes de aprobarlos, y activar la confirmación para operaciones que cambian contenido.
Los invitados del espacio no pueden conectar Notion MCP. Además, la presencia de una herramienta no garantiza que todas sus opciones estén disponibles en el plan conectado: la documentación distingue disponibilidad, límites y comportamientos alternativos. Condiciones comprobadas el 2026-10-25. Si una búsqueda informa de restricciones, debe revisarse ese resultado antes de interpretar su alcance.
En una organización que necesita gestionar la autorización desde su proveedor de identidad, existe una vía específica para el plan Enterprise con SAML SSO. No es el mismo recorrido que autorizar una conexión individual en el navegador: depende de una configuración que activa la administración del espacio. La documentación comprueba esa relación al emitir y utilizar los tokens. Si se desactiva la opción, se elimina el inicio de sesión corporativo o se cambia de proveedor de identidad, los tokens existentes dejan de funcionar. Antes de planificar ese uso debe confirmarse que el espacio mantiene las condiciones exigidas, comprobadas el 2026-10-25.
Enlaces oficiales
Fuentes consultadas
Documentación
- Notion MCP · Notion
- Connect to Notion MCP · Notion
- Supported tools · Notion
- Security best practices · Notion
- Enterprise-managed authorization · Notion
Secundarias
- Notion MCP (descubrimiento) · cual.aiFuente secundaria