MCPgee
MCPgee
MCPgeeMCPgee

Better Notion Server

v1.0.0•Knowledge & Memory•stable

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

ai-agentsai-codingclaudeclaude-codecursor
Share:
28
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Better Notion Server?

Better Notion Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to markdown-first notion api server for ai agents -- 10 composite tools replacing 28+ endpoint calls

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

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Markdown-first Notion API server for AI agents -- 10 composi

Use Cases

Markdown-first Notion API
Composite tools
AI agent integration
n24q02m

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 9, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx better-notion

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Better Notion Server

Better Notion MCP is a Markdown-first Notion API server for AI agents that consolidates over 28 Notion API endpoints into 11 composite tools, reducing the token overhead of managing Notion workspaces from an AI client. It offers 45 granular actions covering pages, databases, blocks, users, comments, and file uploads, with native Markdown-to-blocks and blocks-to-Markdown conversion built in. Developers and power users choose it over the official Notion MCP integration because it is optimised for LLM consumption — compressed descriptions, auto-pagination, and bulk operations — rather than raw API exposure.

Prerequisites

  • A Notion account and an internal integration token from https://www.notion.so/my-integrations
  • Node.js 18 or later (for local stdio mode) or Docker (for remote HTTP mode)
  • Bun runtime (for building from source)
  • An MCP client such as Claude Desktop, Cursor, or Claude Code
1

Create a Notion integration and copy the token

Go to https://www.notion.so/my-integrations, create a new internal integration, and copy the 'Internal Integration Token' that begins with ntn_. Share the Notion pages or databases you want the AI to access with this integration.

2

Add the server to your MCP client configuration

Add the better-notion server to your MCP client config file, passing the NOTION_TOKEN as an environment variable. This uses npx to run the server without a global install.

3

Configure the client and restart

Save your configuration file and restart your MCP client so it picks up the new server entry.

4

Verify the connection

Ask your AI client to call the workspace info action or search for pages. If the integration token is correct and pages are shared, results should appear immediately.

5

Optional: run in HTTP mode with Docker for multi-user access

For a shared or remote deployment, run the Docker image in HTTP mode with OAuth. Set TRANSPORT_MODE, PUBLIC_URL, and your OAuth credentials.

docker run -p 8080:8080 \
  -e TRANSPORT_MODE=http \
  -e PORT=8080 \
  -e PUBLIC_URL=https://your-domain.com \
  -e NOTION_OAUTH_CLIENT_ID=your-client-id \
  -e NOTION_OAUTH_CLIENT_SECRET=your-client-secret \
  n24q02m/better-notion-mcp:latest

Better Notion Server Examples

Client configuration

Claude Desktop config for running Better Notion in local stdio mode with a Notion integration token.

{
  "mcpServers": {
    "better-notion": {
      "command": "npx",
      "args": ["better-notion"],
      "env": {
        "NOTION_TOKEN": "ntn_your_integration_token_here"
      }
    }
  }
}

Prompts to try

Example prompts once Better Notion is connected to your AI client.

- "Search my Notion workspace for pages about Q4 planning"
- "Create a new page called 'Meeting Notes 2026-06-15' in my Notes database"
- "Query the Tasks database where Status equals 'In Progress'"
- "Append a bullet list of today's action items to my Daily Log page"
- "Convert this markdown document to Notion blocks and add it to my docs database"

Troubleshooting Better Notion Server

API returns 'object not found' for pages or databases

The Notion integration must be explicitly shared with each page or database it needs to access. Open the page in Notion, click the three-dot menu, go to Connections, and add your integration.

NOTION_TOKEN environment variable not recognised

Ensure you are using the Internal Integration Token (starts with ntn_) in stdio mode. OAuth credentials (NOTION_OAUTH_CLIENT_ID, NOTION_OAUTH_CLIENT_SECRET) are only used in HTTP transport mode.

npx better-notion fails to start

Verify Node.js 18 or later is installed with node --version. If the package is not found, try clearing the npx cache with npx clear-npx-cache and re-running.

Frequently Asked Questions about Better Notion Server

What is Better Notion Server?

Better Notion Server is a Model Context Protocol (MCP) server that markdown-first notion api server for ai agents -- 10 composite tools replacing 28+ endpoint calls It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Better Notion Server?

Follow the installation instructions on the Better Notion Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Better Notion Server?

Better Notion Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Better Notion Server free to use?

Yes, Better Notion Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Better Notion Server Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Better Notion Server? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "better-notion": { "command": "npx", "args": ["-y", "better-notion"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Better Notion Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides