Better Notion Mcp

@n24q02m

About Better Notion Mcp

Markdown-First MCP Server for Notion - Composite Actions, Auto-Pagination, Bulk Operations optimized for AI Agents

#docker #typescript #mcp #notion #ai-agents #notion-api #model-context-protocol #mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "better-notion": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NOTION_TOKEN",
        "n24q02m/better-notion-mcp:latest"
      ],
      "env": {
        "NOTION_TOKEN": "your_token_here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Better Notion Mcp?

Better Notion Mcp is a Markdown-first MCP server for Notion, optimized for AI agents. It consolidates Notion’s 28+ REST API endpoints into 7 mega action-based tools that perform composite operations, auto-pagination, and bulk actions.

How to use Better Notion Mcp?

Install via npx or Docker. Set the NOTION_TOKEN environment variable with your Notion integration token. Configure the server in your MCP client (e.g., Claude Desktop) using the provided JSON snippet. No additional dependencies are required for usage.

Key features of Better Notion Mcp

7 mega action-based tools covering 30+ actions
Markdown content format (human-readable, token-efficient)
Composite actions (create page + content + properties in one call)
Transparent auto-pagination for large datasets
Native bulk operations for multiple items
Smart search that auto-detects best match in database queries

Use cases of Better Notion Mcp

AI agents creating and updating Notion pages with markdown content in a single call
Performing bulk create/update/delete operations on multiple Notion items
Automating database queries with intelligent search instead of manual filters
Reducing token usage and context overhead in AI workflows

FAQ from Better Notion Mcp

How does Better Notion Mcp differ from the official Notion MCP server?

Better Notion Mcp uses Markdown content format, composite actions, auto-pagination, bulk operations, and smart search, whereas the official server uses raw JSON blocks, atomic operations, manual pagination, and manual filters. It also requires only a NOTION_TOKEN, not OAuth.

What are the runtime requirements?

You can run it via npx (Node.js required) or Docker. For local development, the project uses Node.js 22 and pnpm managed by mise.

How do I get a Notion token?

Create an integration at https://www.notion.so/my-integrations, copy the token, and share your Notion pages with that integration.

Can I perform bulk operations?

Yes, the server supports native batch support for creating, updating, and deleting multiple items at once.

Does Better Notion Mcp support markdown?

Yes, all content is handled in markdown format, making it human-readable and optimized for AI agent context windows.

Frequently asked questions

How does Better Notion Mcp differ from the official Notion MCP server?

What are the runtime requirements?

You can run it via `npx` (Node.js required) or Docker. For local development, the project uses Node.js 22 and pnpm managed by `mise`.

How do I get a Notion token?

Create an integration at https://www.notion.so/my-integrations, copy the token, and share your Notion pages with that integration.

Can I perform bulk operations?

Yes, the server supports native batch support for creating, updating, and deleting multiple items at once.

Does Better Notion Mcp support markdown?

Yes, all content is handled in markdown format, making it human-readable and optimized for AI agent context windows.

Comments

Basic information

More Memory & Knowledge MCP servers

Rust Docs MCP Server

Govcraft

🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.

286