Markdown-first Notion MCP server — 26 tools, 92% fewer tokens, full round-trip fidelity
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"notion": {
"env": {
"NOTION_TOKEN": "ntn_your_integration_token"
},
"args": [
"-y",
"easy-notion-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Markdown-first MCP server that connects AI agents to Notion. Agents write markdown — easy-notion-mcp converts it to Notion's block API and back again.
This server supports HTTP transport. Be the first to test it — help the community know if it works.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked easy-notion-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in productivity / writing
Persistent memory using a knowledge graph
Dynamic problem-solving through sequential thought chains
mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local
A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.
MCP Security Weekly
Get CVE alerts and security updates for Easy Notion Mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Markdown-first MCP server that connects AI agents to Notion.
Agents write markdown — easy-notion-mcp converts it to Notion's block API and back again.
42 tools · 24 block types · 92% fewer tokens vs official Notion MCP · Full round-trip fidelity
npx easy-notion-mcp
See it in action → Live Notion page created and managed entirely through easy-notion-mcp.

Contents: Comparison · Setup · CLI profiles · Config · Why markdown · How it works · Tools · MCP resources · Block types · Round-trip · Databases · Security · FAQ · Community
| Feature | easy-notion-mcp | Official Notion MCP (npm) | better-notion-mcp |
|---|---|---|---|
| Content format | ✅ Standard GFM markdown | ❌ Raw Notion API JSON | ⚠️ Markdown (limited block types) |
| Block types | ✅ 24 (toggles, columns, callouts, equations, embeds, tables, file uploads, task lists) | ⚠️ All (as raw JSON) | ⚠️ ~7 (headings, paragraphs, lists, code, quotes, dividers) |
| Round-trip fidelity | ✅ Full — read markdown, modify, write back | ❌ Raw JSON requires block reconstruction | ⚠️ Unsupported blocks silently dropped |
| Tools | 42 individually-named tools | 18 auto-generated from OpenAPI | 9 composite tools (39 actions) |
| File uploads | ✅ file:///path in markdown | ❌ Open feature request | ✅ 5-step lifecycle |
| Prompt injection defense | ✅ Content notice prefix + URL sanitization | ❌ | ❌ |
| Database entry format | Simple {"Status": "Done"} key-value pairs | Simplified key-value pairs | Simplified key-value pairs |
| Auth options | API token or OAuth | API token or OAuth | API token or OAuth |
| Operation | easy-notion-mcp | better-notion-mcp | Official Notion MCP | Savings vs Official |
|---|---|---|---|---|
| Page read | 291 tokens | ⚠️ 236 tokens | 6,536 tokens | 95.5% |
| DB query (5 rows) | 347 tokens | 704 tokens | 2,983 tokens | 88.4% |
| Search (3 results) | 298 tokens | 347 tokens | 1,824 tokens | 83.7% |
| Total (weighted) | 936 tokens | 1,287 tokens | 11,343 tokens | 91.7% |
⚠️ better-notion-mcp page reads appear smaller because they silently drop 11 block types (callouts, toggles, tables, task lists, equations, bookmarks, embeds). On equal content coverage, easy-notion-mcp is more efficient.
Measured by running all three MCP servers against the same Notion content and counting tokens with tiktoken cl100k_base. Raw responses saved for verification.
Create a Notion integration