Better Notion

You use the Better Notion MCP Server to expose Notion as a set of composite, AI-friendly actions. It consolidates many Notion REST endpoints into easy-to-call operations, supports remote (OAuth) and local token modes, and provides tooling that lets AI agents interact with Notion data efficiently from your preferred MCP client.

How to use

Use an MCP client to connect to the Better Notion MCP server and perform Notion actions through higher-level composites. You can run the server remotely via its HTTP endpoint or locally from your environment using a token-based workflow. The HTTP option is suitable when you want a hosted MCP URL, while the local options let you run the server on your own machine or inside a container.

How to install

Prerequisites: you need a modern Node.js environment and a Notion integration token when running locally. The server supports both remote HTTP access and local stdio execution.

{
  "mcpServers": {
    "better-notion": {
      "type": "http",
      "url": "https://better-notion-mcp.n24q02m.com/mcp",
      "args": []
    }
  }
}

Additional notes

If you host the server locally, you can run it in different modes. In packaging mode, you install via a package manager and provide your Notion token. In Docker mode, you pass the token as an environment variable. The server also supports a self-hosted remote setup with a public Notion OAuth application.

Local package manager (recommended): you install and run the MCP from a package registry using Bun, and you provide your Notion integration token.

Docker-based local run: you can start a container with NOTION_TOKEN supplied through environment variables.

Self-hosted remote mode: you run the server with OAuth, supply your public Notion integration credentials, and configure redirect URLs accordingly.

Security and hosting notes

When running remotely, ensure your public URL is reachable from your clients and that OAuth redirects are properly configured. When running locally, protect your Notion integration token and use secure channels for any external clients.

Available tools

pages

Operations for page creation, retrieval, property updates, moving, archiving, restoring, and duplicating pages.

databases

Manage databases: create, get, query, update pages, delete pages, and handle data sources or templates.

blocks

Access and manipulate content blocks: fetch, navigate, append content, update blocks, and delete blocks.

users

List users, fetch current user details, and derive workspace membership.

workspace

Query workspace information and perform workspace searches.

comments

List and create comments associated with Notion content.

content_convert

Convert between Markdown and Notion blocks for flexible content editing.

file_uploads

Create, send, complete, retrieve, and list file uploads in Notion.

help

Retrieve full documentation for any tool or feature as needed.