Is Better Notion free?

Yes, Better Notion is free to use.

How do I install Better Notion?

Better Notion supports both local and remote installation. For local use, install it via npm (npx) and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

What credentials does Better Notion need?

Better Notion requires the following credentials or environment variables: NOTION_TOKEN. You can find setup instructions on the server detail page.

What AI apps work with Better Notion?

Better Notion uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Better Notion MCP Server

by N24q02m

ProductivityLow Risk10.0MCP RegistryLocalRemote

Free

Server data from the Official MCP Registry

Markdown-first MCP server for Notion API with 9 composite tools and 39+ actions.

About

Markdown-first MCP server for Notion API with 9 composite tools and 39+ actions.

Remote endpoints: streamable-http: https://better-notion-mcp.n24q02m.com/mcp

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (3 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (7/7 approved); 3 highly-trusted packages.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

Notion integration token. Create at https://www.notion.so/my-integrationsRequired

Environment variable: NOTION_TOKEN

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

Better Notion MCP

mcp-name: io.github.n24q02m/better-notion-mcp

Markdown-first Notion API server for AI agents -- 10 composite tools replacing 28+ endpoint calls

Features

Markdown in, Markdown out -- human-readable content instead of raw JSON blocks
10 composite tools with 44 actions -- one call instead of chaining 2+ atomic endpoints
Auto-pagination and bulk operations -- no manual cursor handling or looping
Tiered token optimization -- ~77% reduction via compressed descriptions + on-demand help tool
Dual transport -- local stdio (token) or remote HTTP (OAuth 2.1, no token needed)

Setup

With AI Agent -- copy and send this to your AI agent:

Please set up @n24q02m/better-notion-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-notion-mcp/main/docs/setup-with-agent.md

Manual Setup -- follow docs/setup-manual.md

Tools

Tool	Actions	Description
`pages`	`create`, `get`, `get_property`, `update`, `move`, `archive`, `restore`, `duplicate`	Create, read, update, and organize pages
`databases`	`create`, `get`, `query`, `create_page`, `update_page`, `delete_page`, `create_data_source`, `update_data_source`, `update_database`, `list_templates`	Database CRUD and page management within databases
`blocks`	`get`, `children`, `append`, `update`, `delete`	Read and manipulate block content
`users`	`list`, `get`, `me`, `from_workspace`	List and retrieve user information
`workspace`	`info`, `search`	Workspace metadata and cross-workspace search
`comments`	`list`, `get`, `create`	Page and block comments
`content_convert`	`markdown-to-blocks`, `blocks-to-markdown`	Convert between Markdown and Notion blocks
`file_uploads`	`create`, `send`, `complete`, `retrieve`, `list`	Upload files to Notion
`setup`	`status`, `start`, `reset`, `complete`	Credential setup via browser relay, status check, reset, re-resolve
`help`	-	Get full documentation for any tool

MCP Resources

URI	Description
`notion://docs/pages`	Page operations reference
`notion://docs/databases`	Database operations reference
`notion://docs/blocks`	Block operations reference
`notion://docs/users`	User operations reference
`notion://docs/workspace`	Workspace operations reference
`notion://docs/comments`	Comment operations reference
`notion://docs/content_convert`	Content conversion reference
`notion://docs/file_uploads`	File upload reference

Zero-Config Setup

No environment variables needed. On first start, the server opens a setup page in your browser:

Start the server (via plugin, npx, or Docker)
A setup URL appears -- open it in any browser
Fill in your credentials on the guided form
Credentials are encrypted and stored locally

Your credentials never leave your machine. The relay server only sees encrypted data.

For CI/automation, you can still use environment variables (see below).

Configuration

Variable	Required	Default	Description
`NOTION_TOKEN`	Yes (stdio)	-	Notion integration token
`TRANSPORT_MODE`	No	`stdio`	Set to `http` for remote mode
`PUBLIC_URL`	Yes (http)	-	Server's public URL for OAuth redirects
`NOTION_OAUTH_CLIENT_ID`	Yes (http)	-	Notion Public Integration client ID
`NOTION_OAUTH_CLIENT_SECRET`	Yes (http)	-	Notion Public Integration client secret
`DCR_SERVER_SECRET`	Yes (http)	-	HMAC secret for stateless client registration
`PORT`	No	`8080`	Server port

Self-Hosting (Remote Mode)

You can self-host the remote server with your own Notion OAuth app.

Prerequisites:

Create a Public Integration at https://www.notion.so/my-integrations
Set the redirect URI to https://your-domain.com/callback
Note your client_id and client_secret

docker run -p 8080:8080 \
  -e TRANSPORT_MODE=http \
  -e PUBLIC_URL=https://your-domain.com \
  -e NOTION_OAUTH_CLIENT_ID=your-client-id \
  -e NOTION_OAUTH_CLIENT_SECRET=your-client-secret \
  -e DCR_SERVER_SECRET=$(openssl rand -hex 32) \
  n24q02m/better-notion-mcp:latest

Security

OAuth 2.1 + PKCE S256 -- Secure authorization with code challenge
Rate limiting -- 120 req/min/IP on HTTP transport
Session owner binding -- IP check + TTL for pending token binds
Null safety -- Handles Notion API quirks (comments.list 404, undefined rich_text)

Build from Source

git clone https://github.com/n24q02m/better-notion-mcp.git
cd better-notion-mcp
bun install
bun run dev

License

MIT -- See LICENSE.

Reviews

No reviews yet

Be the first to review this server!

More Productivity MCP Servers

Memory

Free

by Modelcontextprotocol · Productivity

Knowledge graph-based persistent memory across sessions

Time

Free

by Modelcontextprotocol · Productivity

Time and timezone conversion capabilities for your AI assistant

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

Better Notion MCP Server

About

Security Report