Notion Memory MCP 🧠

Un servidor de Model Context Protocol que convierte Notion en un nivel de memoria programable para agentes de IA.

Dale a cualquier agente compatible con MCP (Hermes, Claude Desktop, Cursor, agentes personalizados) cinco herramientas limpias para buscar, leer, guardar, añadir y consultar tu espacio de trabajo de Notion — convirtiendo a Notion en la capa de "disco" persistente de la arquitectura de memoria de 3 niveles de un agente.

⚡ L1 cache  → agent built-in memory (always in context)
🧮 RAM       → mem0 / vector store (auto recall)
💾 DISK      → Notion via this MCP ← you are here

Por qué

Las soluciones de memoria para agentes (mem0, honcho...) son opacas — excelentes para el recuerdo reflejo, invisibles para los humanos. Notion es lo contrario: totalmente visible y editable por humanos, pero no invocable de forma nativa mediante herramientas.

Este servidor las une: los agentes obtienen acceso programático; los humanos mantienen el control visual completo.

Related MCP server: Notion MCP Server

Herramientas expuestas

Configuración

pip install -r requirements.txt
export NOTION_API_TOKEN=ntn_your_integration_token   # notion.so/my-integrations
python3 server.py                                     # stdio transport

Hermes Agent

hermes mcp add notion-memory -- python3 /path/to/server.py
# with env: NOTION_API_TOKEN set in ~/.hermes/.env

Claude Desktop / Cursor

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "notion-memory": {
      "command": "python3",
      "args": ["/path/to/server.py"],
      "env": { "NOTION_API_TOKEN": "ntn_..." }
    }
  }
}

Decisiones de diseño

• Upsert por título (notion_save): los agentes piensan en nombres, no en UUIDs. Volver a guardar reemplaza el cuerpo — escrituras idempotentes.

• Markdown-ish → bloques: encabezados (#), viñetas (-), párrafos se mapean a bloques nativos de Notion. Sin AST complejo.

• Lectura abierta, escritura con alcance: las lecturas alcanzan lo que la integración pueda ver; solo crear/actualizar. Sin herramienta de borrado por diseño — las operaciones destructivas siguen siendo solo humanas.

• stdlib + httpx + mcp: dependencias mínimas, fácil auditoría.

Habilidades demostradas

Desarrollo de servidores MCP · Python asíncrono (httpx + asyncio) · API de Notion (búsqueda/bloques/bases de datos) · diseño de protocolo para uso de herramientas por LLM · mapeo defensivo de errores de API

Licencia

MIT — construido por Shahjalal Shanto

Parte de una arquitectura de memoria de agente: caché integrada + RAM mem0 + disco Notion.