Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/notion
Open on GitHub

What 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/notion

Replace <…> 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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open