Markdown-first Notion access for agents, handling pages, databases, blocks, comments and file uploads through composite tools in one call.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add better-notion --env NOTION_TOKEN='<NOTION_TOKEN>' -- npx -y @n24q02m/better-notion-mcp~/.codex/config.toml
[mcp_servers.better-notion]
command = "npx"
args = ["-y", "@n24q02m/better-notion-mcp"]
env = { NOTION_TOKEN = "<NOTION_TOKEN>" }
# codex mcp add better-notion --env NOTION_TOKEN='<NOTION_TOKEN>' -- npx -y @n24q02m/better-notion-mcp~/.cursor/mcp.json
{
"mcpServers": {
"better-notion": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"better-notion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"better-notion": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"better-notion": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"better-notion": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Environment variables
NOTION_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.