better-notion-mcp — Notion MCP server for Claude Code: install
The better-notion-mcp server lets an AI agent work with Notion pages, databases, blocks, and comments using Markdown. Use it when an agent needs to read or edit workspace content.
Apache-2.0 ★ 36 updated 2026-10-28
claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/notionWhat better-notion-mcp does
better-notion-mcp exchanges Notion content with an agent as Markdown rather than raw JSON blocks. It provides 8 composite tools covering 39 actions, grouping work that would otherwise require several separate Notion calls. Pagination and bulk operations are handled automatically.
Choose local stdio with a Notion integration token, or remote HTTP with OAuth 2.1. Local setup requires Node.js version 24 or later and a Notion token supplied as NOTION_TOKEN. The local connection will not work without that integration token.
What it helps with
- create a Notion page from Markdown
- find and update database entries
- read the blocks on a page
- add a comment to a page
- process multiple Notion items in one request
Example prompts for the agent
- Create a Notion page from this Markdown and place it in the right section.
- Find database entries matching this condition and update them.
- Read the blocks on this Notion page, then add a comment.
How to install better-notion-mcp
Platform CLI
claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/notionReplace <…> with your own values
Platform CLI
codex mcp add n24q02m-better-notion-mcp --env NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/notionReplace <…> with your own values
Config file
{
"mcpServers": {
"n24q02m-better-notion-mcp": {
"command": "npx",
"args": [
"-y",
"@n24q02m/notion"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"n24q02m-better-notion-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@n24q02m/notion"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NOTION_TOKEN=<NOTION_TOKEN> n24q02m-better-notion-mcp npx -y @n24q02m/notionReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about better-notion-mcp
How do I install better-notion-mcp in Claude Code?
Run claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/notion. Replace <NOTION_TOKEN> with your Notion integration token.
What does better-notion-mcp do?
It gives an AI agent tools for working with Notion pages, databases, blocks, and comments. Content passes between the agent and Notion as Markdown.
What is required for local use of better-notion-mcp?
Local stdio setup requires Node.js version 24 or later and a Notion integration token provided through NOTION_TOKEN.