Notion Memory MCP 🧠

一个将 Notion 变成 AI 智能体可编程记忆层的 Model Context Protocol 服务器。

为任何兼容 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_..." }
    }
  }
}

设计决策

• 按标题更新或插入（notion_save）：智能体以名称而非 UUID 思考。重新保存会替换正文——幂等写入。

• 类 Markdown → 块：标题（#）、项目符号（-）、段落映射为 Notion 原生块。无需复杂的 AST。

• 读取开放、写入受限：读取可访问集成所能看到的一切；仅支持创建/更新。设计上不提供删除工具——破坏性操作仅限人工。

• stdlib + httpx + mcp：依赖最少，易于审计。

展示的技能

MCP 服务器开发 · 异步 Python（httpx + asyncio）· Notion API（search/blocks/databases）· 面向 LLM 工具使用的协议设计 · 防御式 API 错误映射

许可证

MIT — 由 Shahjalal Shanto 构建

智能体记忆架构的一部分：内置缓存 + mem0 内存 + Notion 磁盘。