Better Notion MCP Server
Japanese / 日本語 An MCP server that lets you operate Notion with a single Markdown document. Its 9 documented tools cluster into read & search, update, create & write, schema. It runs locally over stdio via the published package.
People who work with Notion and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-02-19 · ★ 2 · #127 OF 160 MAINTAINED PRODUCTIVITY · VERIFIED 2026-09-18
NOASSERTION · TypeScript servers · how we verify → /methodology
01 · Install Better Notion
before you install - you'll need
NOTION_API_KEY
Environment variables documented in the project's README - it lists which are required and which have defaults.
Claude Code
claude mcp add ai-aviate-better-mcp-notion -- npx -y better-mcp-notionClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"ai-aviate-better-mcp-notion": {
"command": "npx",
"args": [
"-y",
"better-mcp-notion"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license no standard license detected - usage rights unclear; check the repo before commercial use
npm package better-mcp-notion - unscoped; check the name against the project README before installing
registry namespace io.github.ai-aviate is GitHub-verified and matches the repo owner
03 · What Better Notion can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can read a Notion page as Markdown with frontmatter. Supports recursive child page reading with depth, create or update pages from Markdown. Supports batch operations and append/prepend, search the workspace by keyword. Returns a Markdown-formatted list, and list database records as a table or child pages as a list. Supports natural language filter & sort.
Capability map
Tools grouped from the project's README - what Better Notion lets an agent do.
read & search
3 tools - e.g. Read a Notion page as Markdown with frontmatter. Supports recursive child page reading with depth.; Search the workspace by keyword. Returns a Markdown-formatted list.; List database records as a table or…
read · search · list
update
2 tools - e.g. Quick property update without rewriting content. Just pass page + key-value pairs.; Move a page to a different parent page or database.
update · move
create & write
1 tool - e.g. Create or update pages from Markdown. Supports batch operations and append/prepend.
write
Schema
1 tool - e.g. View or modify database schema - add, remove, or rename columns.
schema
Comment
1 tool - e.g. Add or read comments on a page.
comment
delete
1 tool - e.g. Archive (soft-delete) a page.
delete
04 · Who maintains Better Notion
better-notion is maintained by ai-aviate. It's the only MCP server we track from this author; the repo dates to Feb 2026.
05 · Facts
- repository
- github.com/ai-aviate/better-mcp-notion
- category
- productivity - ranked #127 of 160 actively-maintained productivity servers as of 2026-09-18.
- registry
- io.github.ai-aviate/better-notion (active, first published 2026-02-19)
- packages
- npm:better-mcp-notion
06 · Better Notion FAQ
Is Better Notion still maintained?
Yes - as of 2026-09-18, its last commit was 2026-02-19. We re-verify nightly.
What can Better Notion do?
With this server connected, an agent can read a Notion page as Markdown with frontmatter. Supports recursive child page reading with depth, create or update pages from Markdown. Supports batch operations and append/prepend, search the workspace by keyword. Returns a Markdown-formatted list, and list database records as a table or child pages as a list. Supports natural language filter & sort.
How do I install Better Notion?
Run `npx -y better-mcp-notion`. The README documents one environment variable (NOTION_API_KEY) to set first. You can also paste the ready-made client config above.
Does Better Notion run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Better Notion
Alternatives to Better Notion
Maintained productivity servers if Better Notion isn't the fit.
- Reactive Resume Free open-source resume builder with remote MCP tools for resumes and job applications. ★ 43,123 · 2026-09-17
- Kaneo Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients ★ 9,115 · 2026-09-17
- Praison AI AI Agents Framework with Self Reflection and MCP support ★ 9,069 · 2026-09-18
- Basic Memory Local-first knowledge management with bi-directional LLM sync via Markdown files. ★ 3,986 · 2026-09-16
- Mindwtr Task and project automation for local and self-hosted Mindwtr Cloud data; read-only by default. ★ 2,063 · 2026-09-18
- Pm Claude Skills 1174 professional Agent Skills + workflow recipes - searchable & fetchable over MCP. ★ 1,369 · 2026-09-17
Pairs well with
Servers that cover what Better Notion doesn't - only shown when the pairing reason fits the companion.
More productivity MCP servers · Joplin MCP Server · Gtasks MCP · Aman Amith Shastry Scientific Computation MCP · Amazing Marvin (complete)
More TypeScript MCP servers · Kira · Aibtcdev MCP Server · Aicanvas (aicanvas-me) · Companies House · Aidemd Mcp MCP Server · see all