Notion MCP

Descripción general

Notion MCP es el servidor oficial alojado del Model Context Protocol (MCP) proporcionado por Notion. Permite que asistentes de IA y agentes interactúen de forma segura y eficiente con espacios de trabajo de Notion utilizando el estándar abierto MCP.

En lugar de gestionar claves API o autoalojar el servidor, los usuarios se conectan mediante una simple autenticación OAuth 2.0 con PKCE. El servidor se ejecuta en https://mcp.notion.com/mcp (transporte HTTP transmitido recomendado) y https://mcp.notion.com/sse (copia de seguridad).

Es mantenido activamente por Notion y está optimizado para flujos de trabajo de IA modernos, reemplazando al servidor notion-mcp-server de código abierto heredado, que ya no recibe mantenimiento activo.

Características clave

• Autenticación segura OAuth: Alcance granular de permisos durante la conexión: no se exponen tokens de larga duración.
• Más de 20 herramientas optimizadas para IA: Incluye notion-search (en todo el espacio de trabajo y fuentes conectadas como Slack, Google Drive, Jira), consultas a bases de datos (actualizadas para la API del 2025-09 03 con fuentes de datos), creación de páginas, añadido de bloques, actualización de propiedades, comentarios y más.
• Acceso bidireccional en tiempo real: Lectura de contenido enriquecido (convertido automáticamente a Markdown para eficiencia de tokens), creación/actualización de páginas y bases de datos, adición de comentarios.
• Infraestructura cero: Completamente alojado y siempre actualizado: no se requiere Docker, servidores o mantenimiento.
• Soporte de transmisión en tiempo real (streaming): Transporte moderno para respuestas más rápidas y una mejor experiencia del agente.
• Amplia compatibilidad con clientes: Soporte nativo en Claude Desktop, Cursor, VS Code, ChatGPT (con ajustes en los nombres de herramientas) y clientes MCP personalizados.

Cómo funciona

Notion aloja tanto el servidor MCP como la API subyacente de Notion. Los clientes MCP en tus herramientas de IA descubren las herramientas disponibles automáticamente, las invocan mediante lenguaje natural y reciben resultados estructurados. Un pipeline de generación de código convierte los esquemas OpenAPI de Notion en herramientas MCP validadas (usando Zod), garantizando alta calidad y consistencia.

Opciones de configuración

• Recomendado: Conexión de un clic desde la galería o importación directa de URL (https://mcp.notion.com/mcp).
• Claude: claude mcp add --transport http notion https://mcp.notion.com/mcp y luego autenticar vía /mcp.
• Cursor: Añadir como servidor MCP global en la configuración.
• Clientes personalizados: Seguir la guía OAuth + PKCE de Notion para construir tus propias integraciones.

Notion MCP vs el servidor heredado de código abierto

El repositorio heredado de GitHub (makenotion/notion-mcp-server) sigue disponible pero ya no recibe mantenimiento activo. Notion recomienda encarecidamente la versión alojada por seguridad, rendimiento, facilidad de uso y compatibilidad con los últimos cambios de la API.

Casos de uso

• Trabajadores del conocimiento que resumen notas y crean automáticamente elementos de acción.
• Desarrolladores que consultan especificaciones/bases de datos de Notion directamente en Cursor o Claude mientras programan.
• Equipos que construyen agentes autónomos que gestionan hojas de ruta, wikis, tareas y comentarios.
• Creadores de contenido que generan y mantienen documentos vivos con referencias cruzadas en tiempo real.

Herramientas Soportadas (Lista Parcial)

• notion-search — búsqueda de texto completo potente con filtros.
• Operaciones de bases de datos y fuentes de datos (consulta, creación, actualización).
• Gestión de páginas y bloques (añadir, actualizar texto enriquecido).
• Comentarios y listado de espacios de trabajo.

Las herramientas se mantienen actualizadas con la evolución de la API de Notion.

Comenzar

Visita la documentación oficial en developers.notion.com/guides/mcp/mcp para conectar tus herramientas de IA hoy.

Notion MCP representa el estándar para una integración fluida y segura entre IA y herramientas de productividad — el "USB-C para agentes de IA" en el ecosistema Notion.