<aside> ℹ️

🚀 Markdown in. Notion out. 87% fewer tokens. This page was built entirely by an AI agent using easy-notion-mcp — every block, image, database, and comment created through MCP tool calls.

</aside>

📊 The Numbers

95%

fewer tokens on page reads

6,536 → 291 tokens

88%

fewer tokens on DB queries

2,983 → 347 tokens

84%

fewer tokens on search

1,824 → 298 tokens

🎨 Rich Content

✍️ Typography & Formatting

Markdown supports bold, italic, strikethrough, inline code, and hyperlinks. You can also nest them freely: bold italic, bold with code inside, and strikethrough with *italic*.

📝 Lists

Bullet & Numbered

• First bullet item
• Second with nesting
  • Nested child
  • Another child
• Third item

1. Numbered one
2. Numbered two
3. Numbered three

Task Lists

• [x] 🎨 Design markdown syntax
• [x] 🔧 Build conversion engine
• [x] 📦 Add file upload support
• [x] 🗄️ Smart database tools
• [x] ✅ Ship 26 tools
• [ ] 🌍 Take over the world

💻 Code Blocks

// One tool call. That's it.
const page = await notion.create_page({
  title: "Sprint Review",
  markdown: `
## Decisions
- Ship v2 by Friday
- Defer mobile to Q3

> [!WARNING]
> Deploy window is Saturday 2-4am only
  `
});

# Smart text search — auto-searches all text fields
results = notion.query_database(
    database_id="abc",
    text="urgent"  # No filter objects needed
)

# Schema inspection — know before you write
schema = notion.get_database(database_id="abc")
# → { properties: [{ name: "Status", type: "select", options: ["Todo", "Done"] }] }

📊 Tables

💬 Callouts

<aside> 💡

Agents write markdown. The server handles the Notion API.

</aside>

<aside> 💚

Call get_database before writing entries to see the schema.

</aside>

<aside> ⚠️

Use update_section for surgical edits instead of replace_content.

</aside>

<aside> 🔴

Round-trip fidelity is a design guarantee, not a happy accident.

</aside>

<aside> ℹ️

87% fewer tokens compared to MCPs that return raw Notion JSON.

</aside>

<aside> ✅

26 tools, 25 block types, SDK v5.13, API 2025-09-03.

</aside>

<aside> ❌

Property 'Stauts' not found. Did you mean 'Status'?

</aside>

🧩 Advanced Blocks