Notion MCP Server

Name: Notion MCP Server
Author: MCP-Mirror

@MCP-Mirror

Repository

About Notion MCP Server

Mirror of

Basic information

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.

Comments

More Memory & Knowledge MCP servers

🧠 Ultimate MCP Server

Dicklesworthstone

Comprehensive MCP server exposing dozens of capabilities to AI agents: multi-provider LLM delegation, browser automation, document processing, vector ops, and cognitive memory systems

154

Semantic Scholar MCP Server

YUZongmin

A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.

158