MCP.so
Sign In
B

Better Notion Mcp

@n24q02m

Repository

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

Basic information

Category

Memory & Knowledge

Transports

stdio

Publisher

n24q02m

Submitted by

n24q02m

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.

Comments

More Memory & Knowledge MCP servers

Notion MCP Server

makenotion

Official Notion MCP Server

4.5K

Memory

modelcontextprotocol

Model Context Protocol Servers

88.1K

Memory Bank MCP Server

alioshr

A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.

913

Jupyter Notebook MCP Server (for Cursor)

jbeno

Model Context Protocol (MCP) server designed to allow AI agents within Cursor to interact with Jupyter Notebook (.ipynb) files

157

Basic Memory

basicmachines-co

AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN

3.4K