What problem does it solve? Working with the Notion API requires constructing verbose block-level JSON payloads, which is error-prone and hard for AI agents to produce reliably. This Skill bridges AI agents to Notion through an MCP server that accepts and returns GitHub-flavored markdown, handling all block JSON conversion automatically. ## Core Features & Use Cases - Markdown-first I/O: Read and write Notion pages as markdown with round-trip fidelity across 24 block types including toggles, columns, callouts, and tables. - Database ergonomics: Add and query database entries with simple property objects like { "Status": "Done" } using automatic schema mapping. - Flexible deployment: Run over stdio with an integration token or over HTTP with OAuth/bearer auth, with optional Redis for shared schema caching across instances. - Use Case: Ask your agent to create a task in a Notion database with a title, status, due date, and markdown description, then query all high-priority open tasks sorted by due date. ## Quick Start Configure the easy-notion-mcp server in your MCP client with your Notion integration token, then ask the agent to read a Notion page as markdown or create a new page from markdown content.
