Notion Memory MCP 🧠

Сервер Model Context Protocol, который превращает Notion в программируемый уровень памяти для ИИ-агентов.

Дайте любому MCP-совместимому агенту (Hermes, Claude Desktop, Cursor, кастомные агенты) пять чистых инструментов для поиска, чтения, сохранения, добавления и запросов к вашему рабочему пространству Notion — превращая Notion в постоянный «дисковый» слой трёхуровневой архитектуры памяти агента.

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

Зачем

Решения для памяти агентов (mem0, honcho...) непрозрачны — отлично подходят для рефлекторного вспоминания, но невидимы для людей. Notion — противоположность: полностью видим и редактируем людьми, но не поддерживает нативные вызовы инструментов.

Этот сервер соединяет их: агенты получают программный доступ; люди сохраняют полный визуальный контроль.

Related MCP server: Notion MCP Server

Доступные инструменты

Настройка

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

Добавьте в ваш MCP-конфиг:

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

Дизайн-решения

• Upsert по названию (notion_save): агенты думают именами, а не UUID. Повторное сохранение заменяет тело — идемпотентные записи.

• Markdown-подобный → блоки: заголовки (#), маркеры (-), абзацы отображаются на нативные блоки Notion. Без сложного AST.

• Чтение открытое, запись ограничена: чтение затрагивает всё, что видит интеграция; только создание/обновление. Инструмента удаления нет по дизайну — разрушительные операции остаются только для людей.

• stdlib + httpx + mcp: минимальные зависимости, лёгкий аудит.

Продемонстрированные навыки

Разработка MCP-сервера · асинхронный Python (httpx + asyncio) · Notion API (поиск/блоки/базы данных) · проектирование протоколов для использования инструментов LLM · защитное сопоставление ошибок API

Лицензия

MIT — создано Shahjalal Shanto

Часть архитектуры памяти агента: встроенный кэш + mem0 RAM + Notion диск.