Skip to main content
Glama
shahjalal2313

notion-memory-mcp

Notion Memory MCP 🧠

Ein Model Context Protocol Server, der Notion in eine programmierbare Speicherebene für KI-Agenten verwandelt.

Gib jedem MCP-kompatiblen Agenten (Hermes, Claude Desktop, Cursor, benutzerdefinierte Agenten) fünf saubere Werkzeuge, um deinen Notion-Arbeitsbereich zu durchsuchen, zu lesen, zu speichern, zu ergänzen und abzufragen – und mache Notion so zur persistenten „Festplatten“-Schicht der dreistufigen Speicherarchitektur eines Agenten.

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

Warum

Agentenspeicherlösungen (mem0, honcho...) sind undurchsichtig – großartig für reflexives Abrufen, aber für Menschen unsichtbar. Notion ist das Gegenteil: für Menschen vollständig sichtbar und bearbeitbar, aber nicht nativ über Werkzeuge aufrufbar.

Dieser Server verbindet beides: Agenten erhalten programmatischen Zugriff; Menschen behalten die volle visuelle Kontrolle.

Related MCP server: Notion MCP Server

Verfügbare Werkzeuge

Werkzeug

Was es tut

notion_search(query)

Seiten/Datenbanken nach Titel oder Inhalt finden

notion_read(page_id)

Eine Seite als strukturierten Klartext lesen

notion_save(title, content)

Seite per exaktem Titel upserten (markdown-ähnlich → Blöcke)

notion_append(page_id, text)

An eine Seite anhängen (fortlaufende Protokolle)

notion_query_db(db_id)

Datenbankzeilen mit optionalem Select-Filter abfragen

Einrichtung

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

Füge zu deiner MCP-Konfiguration hinzu:

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

Designentscheidungen

  • Upsert-by-title (notion_save): Agenten denken in Namen, nicht in UUIDs. Erneutes Speichern ersetzt den Inhalt – idempotente Schreibvorgänge.

  • Markdown-ähnlich → Blöcke: Überschriften (#), Aufzählungen (-), Absätze werden auf native Notion-Blöcke abgebildet. Kein komplexer AST.

  • Lesen offen, Schreiben eingeschränkt: Lesezugriffe treffen alles, was die Integration sehen kann; nur Erstellen/Aktualisieren. Bewusst kein Lösch-Werkzeug – destruktive Operationen bleiben Menschen vorbehalten.

  • stdlib + httpx + mcp: minimale Abhängigkeiten, einfache Prüfung.

Demonstrierte Fähigkeiten

MCP-Server-Entwicklung · asynchrones Python (httpx + asyncio) · Notion-API (Suche/Blöcke/Datenbanken) · Protokolldesign für LLM-Werkzeugnutzung · defensive API-Fehlerzuordnung

Lizenz

MIT — erstellt von Shahjalal Shanto

Teil einer Agentenspeicherarchitektur: integrierter Cache + mem0-RAM + Notion-Festplatte.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers