Easy Notion Mcp

What is Easy Notion Mcp?

Easy Notion Mcp is a markdown-first MCP server that connects AI agents to Notion. It converts standard GFM markdown to Notion's block API and back, supporting 26 tools and 25 block types with full round-trip fidelity.

How to use Easy Notion Mcp?

Install via npx easy-notion-mcp. Use OAuth (HTTP server with npx easy-notion-mcp-http) or an API token (NOTION_TOKEN). Configure with any MCP client (Claude Code, Claude Desktop, OpenClaw, Cursor, VS Code Copilot, Windsurf). The server runs on stdio (API token) or HTTP (OAuth).

Key features of Easy Notion Mcp

• 26 individually-named tools across 5 categories.
• 25 block types using standard markdown extended syntax.
• 92% fewer tokens vs official Notion MCP server.
• Full round-trip fidelity – read, modify, write without loss.
• Simple key-value pairs for database entries.
• Built-in prompt injection defense and URL sanitization.

Use cases of Easy Notion Mcp

• Create and edit Notion pages using plain markdown text.
• Manage databases with automatic schema conversion.
• Search, duplicate, move, and archive pages.
• Add comments and list workspace users.
• Upload files via file:///path in markdown.

FAQ from Easy Notion Mcp

How does Easy Notion Mcp compare to other Notion MCP servers?

Easy Notion Mcp uses standard GFM markdown, supports 25 block types, offers 26 tools, and achieves full round-trip fidelity – unlike the official server (raw JSON) or better-notion-mcp (limited block types, dropped content).

How do I set up Easy Notion Mcp?

Two options: OAuth (recommended) – run the HTTP server and connect with any MCP client; API token – create a Notion integration, set NOTION_TOKEN, and share pages with it. Configuration examples for Claude Desktop, Cursor, VS Code, Windsurf, and OpenClaw are provided.

How does Easy Notion Mcp handle databases?

It fetches the database schema at runtime and converts simple key-value pairs (e.g., {"Status": "Done"}) to Notion's property format automatically. Schema is cached for 5 minutes. Tools include create, query, add, update, and delete entries.

What about security and prompt injection?

Easy Notion Mcp adds a content notice prefix to read responses and sanitizes URLs to help defend against prompt injection attacks.

Can I read and rewrite pages without losing formatting?

Yes. All 25 supported block types (including toggles, columns, callouts, equations, tables, task lists) round-trip cleanly. Read a page as markdown, modify the string, then write it back – nothing is lost.