Notion Memory MCP 🧠

NotionをAIエージェント向けのプログラム可能なメモリ層に変えるModel Context Protocolサーバー。

あらゆるMCP互換エージェント（Hermes、Claude Desktop、Cursor、カスタムエージェント）に、Notionワークスペースを検索・読み取り・保存・追記・クエリするための5つのクリーンなツールを提供します。これにより、Notionはエージェントの3層メモリアーキテクチャにおける永続的な「ディスク」層になります。

⚡ 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_..." }
    }
  }
}

設計上の決定

• タイトルによるアップサート（notion_save）：エージェントはUUIDではなく名前で考えます。再保存で本文が置き換わります — 冪等な書き込みです。

• マークダウン風 → ブロック：見出し（#）、箇条書き（-）、段落はネイティブのNotionブロックにマッピングされます。複雑なASTは不要です。

• 読み取りはオープン、書き込みはスコープ付き：読み取りは統合が参照できるものすべてにアクセスします。作成/更新のみ。設計上、削除ツールはありません — 破壊的操作は人間のみに限定されます。

• stdlib + httpx + mcp：最小限の依存関係、監査が容易。

実証されたスキル

MCPサーバー開発 · 非同期Python（httpx + asyncio） · Notion API（search/blocks/databases） · LLMツール利用のためのプロトコル設計 · 防御的なAPIエラーマッピング

ライセンス

MIT — Shahjalal Shanto によって構築

エージェントメモリアーキテクチャの一部：組み込みキャッシュ + mem0 RAM + Notionディスク。