Skip to main content
Glama
deenesjakoruzh
shahjalal2313

notion-memory-mcp

by shahjalal2313
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

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

Инструмент

Что делает

notion_search(query)

Найти страницы/базы данных по названию или содержимому

notion_read(page_id)

Прочитать страницу как структурированный обычный текст

notion_save(title, content)

Обновить или создать страницу по точному названию (markdown-подобный → блоки)

notion_append(page_id, text)

Добавить к странице (журналы)

notion_query_db(db_id)

Запросить строки базы данных с необязательным select-фильтром

Настройка

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 диск.

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers