Markdown-first Notion MCP server — 92% fewer tokens, 26 tools, round-trip fidelity.
{
"mcpServers": {
"io-github-misterwigglesworth-easy-notion": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Markdown-first Notion MCP server — 92% fewer tokens, 26 tools, round-trip fidelity.
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
License not specified.
Is it maintained?
Last commit 5 days ago. 4 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Official Notion MCP Server
Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.
🗂️🤖 Airtable Model Context Protocol Server, for allowing AI systems to interact with your Airtable bases
MCP Security Weekly
Get CVE alerts and security updates for io.github.misterwigglesworth/easy-notion 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.
26 tools · 25 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 · Why markdown · How it works · Tools · Block types · Round-trip · Databases · Config · Security · FAQ
| 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 | ✅ 25 (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 | 26 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% |
⚠️ 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.
Run the HTTP server, then connect with any MCP client. OAuth handles authentication — no token to copy-paste.
Start the server:
npx easy-notion-mcp-http
Requires NOTION_OAUTH_CLIENT_ID and NOTION_OAUTH_CLIENT_SECRET env vars. See OAuth setup below.
Claude Code:
claude mcp add notion --transport http http://localhost:3333/mcp
OpenClaw:
openclaw config set mcpServers.notion.transport "http"
openclaw config set mcpServers.notion.url "http://localhost:3333/mcp"