Better Notion MCP is a Markdown-first MCP server that provides AI-optimized, composite tools for interacting with Notion workspaces through human-readable markdown instead of raw JSON blocks.

Core Capabilities:

• Pages: Create, read, update, archive, restore, and duplicate pages with markdown content; set titles, icons, covers, and properties; append or prepend content; batch operations

• Databases: Create and manage databases with custom schemas; query with filters, sorts, and text search; create, update, and delete database pages; manage data sources; bulk operations

• Blocks: Get, append, update, and delete individual blocks; supports headings, paragraphs, lists, code blocks, quotes, dividers, and inline formatting

• Users: List all users, get specific user details by ID, retrieve current authenticated user info

• Workspace: Get workspace information; search across pages and databases with filtering and sorting options

• Comments: List existing comments, create new comment discussions, reply to existing threads

• Content Conversion: Convert between markdown and Notion blocks format (automatic in most tools)

• Help: Get on-demand detailed documentation for any tool

Key Advantages:

• Markdown-first for human readability and AI processing

• Composite operations replacing multiple API requests

• Auto-pagination without manual cursor management

• Native batch operation support

• ~77% token reduction through tiered descriptions and on-demand documentation

Provides markdown-first tools for managing Notion workspaces, including page lifecycle operations (create, update, archive, duplicate), database management with bulk operations, block-level editing, user management, workspace search, and comment operations. Features composite actions that combine multiple operations, auto-pagination, and smart database queries.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Better Notion MCP create a new page in my 'Projects' database with title 'Q4 Planning' and markdown content for our quarterly goals"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.