MCPgee
MCPgee
MCPgeeMCPgee

Better Notion

v2.33.0•Knowledge & Memory•stable

📇 ☁️ 🍎 🪟 🐧 - Markdown-first Notion MCP server with 9 composite tools and 39 actions.

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

What is Better Notion?

Better Notion is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ 🍎 🪟 🐧 - markdown-first notion mcp server with 9 composite tools and 39 actions.

📇 ☁️ 🍎 🪟 🐧 - Markdown-first Notion MCP server with 9 composite tools and 39 actions.

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

Features

  • MCP protocol support

Use Cases

Markdown-first Notion integration
9 composite tools
AI-powered note management
n24q02m

Maintainer

LicenseMIT
Languagetypescript
Versionv2.33.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

NPM

npx -y @n24q02m/better-notion-mcp

Manual Installation

npx -y @n24q02m/better-notion-mcp

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

Better Notion MCP is a Markdown-first Notion integration server that exposes 11 composite tools with 45 actions covering pages, databases, blocks, comments, users, workspace search, and file uploads. Unlike the official Notion MCP, it converts all content to and from Markdown so AI agents can read and write Notion pages without dealing with Notion's block API directly. It supports both local stdio mode with a simple integration token and a full HTTP/OAuth mode for multi-user deployments.

Prerequisites

  • Node.js 18+ (for npx usage) or Docker (for self-hosted HTTP mode)
  • A Notion account with an Internal Integration token from https://www.notion.so/my-integrations
  • The integration must be connected to the Notion pages/databases you want to access
  • An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
  • For HTTP/OAuth mode: a public domain and a Notion Public Integration with OAuth credentials
1

Create a Notion integration and get your token

Go to https://www.notion.so/my-integrations and create a new Internal Integration. Copy the 'Internal Integration Secret' — this is your NOTION_TOKEN.

2

Connect the integration to your Notion pages

Open each Notion page or database you want the server to access. Click the '...' menu, go to 'Connections', and add your integration. The server can only access pages that have been explicitly shared with the integration.

3

Add the server to your MCP client config

Add the following configuration to your claude_desktop_config.json, setting your NOTION_TOKEN as an environment variable.

{
  "mcpServers": {
    "better-notion": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-notion-mcp"],
      "env": {
        "NOTION_TOKEN": "secret_your_integration_token_here"
      }
    }
  }
}
4

Restart your MCP client

Fully restart Claude Desktop or your MCP client to pick up the new server configuration. The server starts automatically via npx on first use.

5

Optional: run in Docker for HTTP/multi-user mode

For team deployments, run the server in HTTP mode with OAuth. Requires a Notion Public Integration and a public domain for the OAuth callback URL.

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 Examples

Client configuration

Minimal stdio configuration for Claude Desktop using a Notion Internal Integration token.

{
  "mcpServers": {
    "better-notion": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-notion-mcp"],
      "env": {
        "NOTION_TOKEN": "secret_your_integration_token_here"
      }
    }
  }
}

Prompts to try

Example prompts to use once the server is connected in Claude Desktop or Claude Code.

- "Search my Notion workspace for notes about Q3 planning"
- "Create a new Notion page in my 'Projects' database titled 'Website Redesign' with a summary"
- "Read the content of my Notion page 'Meeting Notes - June 2026' and summarize it"
- "Add a comment to my Notion page 'Product Roadmap'"
- "List all databases in my Notion workspace"

Troubleshooting Better Notion

Server returns 'object not found' for pages you own

The Notion integration must be explicitly connected to each page. Open the page in Notion, click '...' > Connections, and add your integration. The server cannot access pages that haven't been shared with the integration.

NOTION_TOKEN is invalid or unauthorized

Make sure you copied the full 'Internal Integration Secret' from https://www.notion.so/my-integrations (it starts with 'secret_'). Do not use your personal Notion login password or API key from another service.

npx hangs or fails to download the package

Ensure Node.js 18+ is installed and you have internet access. Try running 'npx -y @n24q02m/better-notion-mcp' in a terminal directly to see the error output.

Frequently Asked Questions about Better Notion

What is Better Notion?

Better Notion is a Model Context Protocol (MCP) server that 📇 ☁️ 🍎 🪟 🐧 - markdown-first notion mcp server with 9 composite tools and 39 actions. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Better Notion?

Install via npm with the command: npx -y @n24q02m/better-notion-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Better Notion?

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

Is Better Notion free to use?

Yes, Better Notion 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 Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Better Notion? 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-mcp": { "command": "npx", "args": ["-y", "@n24q02m/better-notion-mcp"] } } }

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

Read the full setup guide →

Ready to use Better Notion?

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