better-notion-mcp
CommunityMCP server by n24q02m · updated · ★ 36 · 128 downloads a week
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions. better-notion-mcp is a community project by n24q02m, not verified by a company domain.
Last commit 12 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
NOTION_Environment variable, secret | Required | Notion integration token. Create at https://www.notion.so/my-integrations |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install better-notion-mcp
Built from the published package, never by AIclaude mcp add better-notion-mcp -e NOTION_TOKEN=YOUR_NOTION_TOKEN -- npx -y @n24q02m/better-notion-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"better-notion-mcp": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"better-notion-mcp": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"better-notion-mcp": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add better-notion-mcp --env NOTION_TOKEN=YOUR_NOTION_TOKEN -- npx -y @n24q02m/better-notion-mcp{
"mcpServers": {
"better-notion-mcp": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add better-notion-mcp npx -y @n24q02m/better-notion-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the better-notion-mcp block.
Weekly newsletter
Like better-notion-mcp? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to better-notion-mcp
All alternatives →Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Open-source Obsidian for MDX - edit local docs with agent assistance
A private persistent computer: files and a bash shell that survive between runs.
MCP server for terminal commands, file operations, and process management
Filesystem-first framework for durable backend AI agents that run anywhere.
W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.
better-notion-mcp: common questions
How do I install better-notion-mcp?
In Claude Code run claude mcp add better-notion-mcp -e NOTION_TOKEN=YOUR_NOTION_TOKEN -- npx -y @n24q02m/better-notion-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is better-notion-mcp the official server?
better-notion-mcp is a community project by n24q02m, not verified by a company domain.
Is better-notion-mcp free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is better-notion-mcp safe to use?
It scores 75 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to better-notion-mcp?
Similar MCP servers: mcp-server, Agent-Native Content, Computer, Desktop Commander.
Does better-notion-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
