Notion MCP Server

@MCP-Mirror

About Notion MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

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 Notion MCP Server?

An MCP (Model Context Protocol) server that provides a controlled interface to the Notion API, allowing AI assistants to search, read, comment on, and create pages and databases. Designed for developers who want to let LLMs interact with Notion workspaces safely.

How to use Notion MCP Server?

Create a Notion internal integration to obtain a secret token, then add the MCP configuration to your client’s mcp.json or claude_desktop_config.json. Use either npx or Docker, providing the token via the OPENAPI_MCP_HEADERS environment variable. Connect your integration to the pages/databases you want the server to access.

Key features of Notion MCP Server

Wraps the Notion API as an MCP server for LLMs.
Supports searching, reading, commenting, and creating pages.
Deliberately excludes destructive operations like deleting databases.
Works with both npx (Node.js) and Docker.
Allows read-only token configuration for enhanced security.

Use cases of Notion MCP Server

Ask an AI to comment "Hello MCP" on a specific Notion page.
Instruct the AI to create a new page titled "Notion MCP" under a parent page.
Retrieve the content of a page by its ID.

FAQ from Notion MCP Server

What operations does Notion MCP Server support?

It can search for pages, read page content, add comments, and create new pages. Deleting databases is intentionally not supported.

Can I restrict the server to read-only access?

Yes. In the Notion integration settings you can give only "Read content" access, creating a read-only token.

What runtime dependencies are required?

You need either Node.js and npm (to run via npx) or Docker (to build and run the container).

How do I connect my Notion pages to the integration?

Visit each page, click the three dots, and select "Connect to integration" to link it to your integration token.

Where does my data reside?

All data stays in Notion's servers. The MCP server is just a proxy that makes API calls—it does not store or cache your data.

Frequently asked questions

What operations does Notion MCP Server support?

It can search for pages, read page content, add comments, and create new pages. Deleting databases is intentionally not supported.

Can I restrict the server to read-only access?

Yes. In the Notion integration settings you can give only "Read content" access, creating a read-only token.

What runtime dependencies are required?

You need either Node.js and npm (to run via `npx`) or Docker (to build and run the container).

How do I connect my Notion pages to the integration?

Visit each page, click the three dots, and select "Connect to integration" to link it to your integration token.

Where does my data reside?

All data stays in Notion's servers. The MCP server is just a proxy that makes API calls—it does not store or cache your data.

Comments

Basic information

More Memory & Knowledge MCP servers

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763