Better Notion Mcp
by n24q02mcommunityv2.26.0
23
10
Better Notion MCP is a Markdown-first API server for Notion that simplifies interactions by providing 10 composite tools that replace multiple endpoint calls with a single request.
From the registry: Markdown-first MCP server for Notion API with 9 composite tools and 39+ actions.
Install & configure
Prerequisites
- requiredNotion integration tokenCreate a Notion internal integration and share pages/databases with it.https://www.notion.so/my-integrations
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `better-notion-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Notion integration token** — Create a Notion internal integration and share pages/databases with it. (https://www.notion.so/my-integrations)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@n24q02m/better-notion-mcp"]
- required environment variables:
- `NOTION_TOKEN`: Notion internal integration token (example: `<your-notion-token>`)
Note: Supports an HTTP transport mode for self-hosted multi-user setups (OAuth 2.1). stdio is the default and recommended for single-user install.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Supports an HTTP transport mode for self-hosted multi-user setups (OAuth 2.1). stdio is the default and recommended for single-user install.
Tools (10)
pages
Create, read, update, and organize pages.
databases
Database CRUD and page management within databases.
blocks
Read and manipulate block content.
users
List and retrieve user information.
workspace
Workspace metadata and cross-workspace search.
comments
Page and block comments.
content_convert
Convert between Markdown and Notion blocks.
file_uploads
Upload files to Notion.
setup
Credential setup via browser relay, status check, reset, re-resolve.
help
Get full documentation for any tool.
Environment variables
NOTION_TOKENrequiredNotion integration token.PUBLIC_URLrequiredServer's public URL for OAuth redirects.NOTION_OAUTH_CLIENT_IDrequiredNotion Public Integration client ID.NOTION_OAUTH_CLIENT_SECRETrequiredNotion Public Integration client secret.DCR_SERVER_SECRETrequiredHMAC secret for stateless client registration.Packages
@n24q02m/better-notion-mcp
npmv2.26.0transport: stdio
docker.io/n24q02m/better-notion-mcp:latest
ocitransport: stdio
Remote Endpoints
https://better-notion-mcp.n24q02m.com/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- MIT
- Released
- Apr 7, 2026
- Last commit
- Apr 12, 2026
- Registry name
- io.github.n24q02m/better-notion-mcp