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

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?

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

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

n24q02m

Submitted by

n24q02m

More Memory & Knowledge MCP servers

Obsidian MCP Server

cyanheads

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.

618

Obsidian MCP Server

StevenStavrakis

A simple MCP server for Obsidian

717

ctxfile

ctxfile

Local-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.

2

Notion MCP Integration

danhilse

A simple MCP integration that allows Claude to read and manage a personal Notion todo list

208

Zettelkasten MCP Server

entanglr

A Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.

159