Provides tools to search, read, save, append, and query Notion pages and databases, turning Notion into a persistent memory tier for AI agents.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@notion-memory-mcp search my Notion for project notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol server that turns Notion into a programmable memory tier for AI agents.
Give any MCP-compatible agent (Hermes, Claude Desktop, Cursor, custom agents) five clean tools to search, read, save, append, and query your Notion workspace — making Notion the persistent "disk" layer of an agent's 3-tier memory architecture.
⚡ L1 cache → agent built-in memory (always in context)
🧮 RAM → mem0 / vector store (auto recall)
💾 DISK → Notion via this MCP ← you are hereAgent memory solutions (mem0, honcho...) are opaque — great for reflexive recall, invisible to humans. Notion is the opposite: fully visible and editable by humans, but not natively tool-callable.
This server bridges them: agents get programmatic access; humans keep full visual control.
Related MCP server: Notion MCP Server
Tool | What it does |
| Find pages/databases by title or content |
| Read a page as structured plain text |
| Upsert page by exact title (markdown-ish → blocks) |
| Append to a page (running logs) |
| Query database rows with optional select-filter |
pip install -r requirements.txt
export NOTION_API_TOKEN=ntn_your_integration_token # notion.so/my-integrations
python3 server.py # stdio transporthermes mcp add notion-memory -- python3 /path/to/server.py
# with env: NOTION_API_TOKEN set in ~/.hermes/.envAdd to your MCP config:
{
"mcpServers": {
"notion-memory": {
"command": "python3",
"args": ["/path/to/server.py"],
"env": { "NOTION_API_TOKEN": "ntn_..." }
}
}
}Upsert-by-title (notion_save): agents think in names, not UUIDs. Re-saving replaces the body — idempotent writes.
Markdown-ish → blocks: headings (#), bullets (-), paragraphs map to native Notion blocks. No complex AST.
Read-open, write-scoped: reads hit whatever the integration can see; create/update only. No delete tool by design — destructive ops stay human-only.
stdlib + httpx + mcp: minimal dependencies, easy audit.
MCP server development · async Python (httpx + asyncio) · Notion API (search/blocks/databases) · protocol design for LLM tool use · defensive API error mapping
MIT — built by Shahjalal Shanto
Part of an agent-memory architecture: built-in cache + mem0 RAM + Notion disk.
This server cannot be deployed
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
Persistent memory for AI agents. Search and store durable facts, preferences and decisions.
Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.
