Plugin

better-notion-mcp

Name: better-notion-mcp
Author: n24q02m

Automate bulk updates to properties and content across paginated Notion databases with dry-run previews, progress tracking, error recovery, and rate limiting. Transform unstructured pages into structured databases with proper schemas. Interact with pages, databases, notes, and workspaces via a local stdio MCP server using npx.

Notion

database

automation

npx claudepluginhub n24q02m/better-notion-mcp

Component Overview

Skills

MCP Servers

Setup Configuration

This plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.

NOTION_TOKEN

sensitive

From https://www.notion.so/my-integrations (starts with ntn_)

${user_config.NOTION_TOKEN}

Component Details

Skills (2)

bulk-update

/bulk-update

Update properties or content across many pages in a Notion database with dry-run and error recovery

organize-database

/organize-database

Transform unstructured Notion pages into a well-designed database with proper schema and migration

MCP Servers (1)

Connects to external services

better-notion-mcp

1 secret

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)

Status

2026-05-02 -- Architecture stabilization update

Past months saw significant churn around credential handling and the daemon-bridge auto-spawn pattern. This caused multi-process races, browser tab spam, and inconsistent setup UX across plugins. As of v, the architecture is stable: 2 clean modes (stdio + HTTP), no daemon-bridge layer, no auto-spawn from stdio.

Apologies for the instability period. If you encountered issues with prior versions, please update to v+ and follow the current docs/setup-manual.md -- most prior workarounds are no longer needed.

Related plugins from the same author:

wet-mcp -- Web search + content extraction

mnemo-mcp -- Persistent AI memory

imagine-mcp -- Image/video understanding + generation

better-email-mcp -- Email management

better-telegram-mcp -- Telegram

better-godot-mcp -- Godot Engine

better-code-review-graph -- Code review knowledge graph

All plugins share the same architecture -- install once, learn pattern transfers.

Setup

Stdio mode (default) -- env var creds (NOTION_TOKEN), single-user local. See setup-manual.md.
HTTP mode (optional, encouraged) -- multi-user, OAuth 2.1, browser-based setup. See setup-manual.md "Method 5: Self-Hosting HTTP Mode".

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

View full README on GitHub

Similar Plugins

mcp-notion

Notion workspace and database integration

3mo

v1.0.0

Stats

Version2.31.0

Stars28

Forks10

MaintenanceExcellent

Last CommitMay 5, 2026

AddedMar 25, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Safety Signals

Caution

Requires secrets

Needs API keys or credentials to function

Help us improve

Share bugs, ideas, or general feedback.

Back to Plugins

better-notion-mcp

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)

Status

2026-05-02 -- Architecture stabilization update

Past months saw significant churn around credential handling and the daemon-bridge auto-spawn pattern. This caused multi-process races, browser tab spam, and inconsistent setup UX across plugins. As of v, the architecture is stable: 2 clean modes (stdio + HTTP), no daemon-bridge layer, no auto-spawn from stdio.

Apologies for the instability period. If you encountered issues with prior versions, please update to v+ and follow the current docs/setup-manual.md -- most prior workarounds are no longer needed.

Related plugins from the same author:

wet-mcp -- Web search + content extraction
mnemo-mcp -- Persistent AI memory
imagine-mcp -- Image/video understanding + generation
better-email-mcp -- Email management
better-telegram-mcp -- Telegram
better-godot-mcp -- Godot Engine
better-code-review-graph -- Code review knowledge graph

All plugins share the same architecture -- install once, learn pattern transfers.

Setup

Stdio mode (default) -- env var creds (NOTION_TOKEN), single-user local. See setup-manual.md.

HTTP mode (optional, encouraged) -- multi-user, OAuth 2.1, browser-based setup. See setup-manual.md "Method 5: Self-Hosting HTTP Mode".

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

Tools

better-notion-mcp

Component Overview

Setup Configuration