Better Notion
Connects to Notion's API but cuts out the usual multi-call dance. Instead of chaining search, get schema, create page, and append blocks across separate requests, you hand it a single Markdown document with YAML frontmatter and it handles creation or updates in one shot. Supports batch operations, recursive child page reads, natural language database filters, and schema modifications. The frontmatter maps directly to Notion properties, so you can create database entries or update page metadata without touching raw JSON blocks. Built for workflows where you want to treat Notion pages like files rather than API endpoints.
- GitHub stars
- 2
- tools
- 9
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Feb 19, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
readRead a Notion page as Markdown with frontmatter. Supports recursive child page reading with `depth`.
Read a Notion page as Markdown with frontmatter. Supports recursive child page reading with `depth`.
No parameter schema in public metadata yet.
writeCreate or update pages from Markdown. Supports batch operations and append/prepend.
Create or update pages from Markdown. Supports batch operations and append/prepend.
No parameter schema in public metadata yet.
searchSearch the workspace by keyword. Returns a Markdown-formatted list.
Search the workspace by keyword. Returns a Markdown-formatted list.
No parameter schema in public metadata yet.
listList database records as a table or child pages as a list. Supports natural language filter & sort.
List database records as a table or child pages as a list. Supports natural language filter & sort.
No parameter schema in public metadata yet.
updateQuick property update without rewriting content. Just pass page + key-value pairs.
Quick property update without rewriting content. Just pass page + key-value pairs.
No parameter schema in public metadata yet.
schemaView or modify database schema — add, remove, or rename columns.
View or modify database schema — add, remove, or rename columns.
No parameter schema in public metadata yet.
commentAdd or read comments on a page.
Add or read comments on a page.
No parameter schema in public metadata yet.
deleteArchive (soft-delete) a page.
Archive (soft-delete) a page.
No parameter schema in public metadata yet.
moveMove a page to a different parent page or database.
Move a page to a different parent page or database.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
NOTION_API_KEY*secretNotion API key (starts with ntn_)
Readme
better-mcp-notion
An MCP server that lets you operate Notion with a single Markdown document.
Existing Notion MCP servers are thin API wrappers that require multiple round-trips for a single operation. better-mcp-notion uses one Markdown document (YAML frontmatter + body) to read, create, and update pages in a single call.
Why better-mcp-notion?
| Traditional Notion MCP | better-mcp-notion | |
|---|---|---|
| Tools | 16-22 tools | 9 tools |
| Create a DB entry | 3+ calls (search DB, get schema, create page, append blocks) | 1 call |
| Edit a page | 4+ calls (get page, get blocks, delete blocks, append blocks) | 1 call (read, edit, write) |
| Format | Raw JSON blocks | Markdown |
| Context window | Heavy (tool definitions + JSON) | Light |
Tools
Details
- Repository
- github.com/ai-aviate/better-mcp-notion
- Category
- Documents & Knowledge
- Package
better-mcp-notion- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Documents & Knowledge MCP servers
View all
Obsidian Brainsweir1/obsidian-brainObsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.7stars
Obsidian MCPseynurmammad0v/obsidian-mcpTurns Obsidian vaults into AI-queryable knowledge graphs with 12 tools1stars
MarkdownPointeryotsuda/markdownpointerMarkdown viewer for AI-assisted document review. Click any element to copy file path + line number.1stars
Llm Wiki Mcpflsteven87/llm-wiki-mcpMCP server for Karpathy-style LLM wikis: persistent markdown your agent grows over time.0stars
Document Parseragenson-tools/document-parser-mcpParse and extract structured data from various document formats (PDF, Word, HTML).0stars