Notion Memory MCP 🧠

AI 에이전트를 위해 Notion을 프로그래밍 가능한 메모리 계층으로 바꿔주는 Model Context Protocol 서버입니다.

MCP 호환 에이전트(Hermes, Claude Desktop, Cursor, 커스텀 에이전트)에 Notion 워크스페이스를 검색, 읽기, 저장, 추가, 조회할 수 있는 다섯 가지 깔끔한 도구를 제공하여 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 디스크.