Advertise
MCP.so
Sign In

Notion MCP Server

@MCP-Mirror

Repository

Basic information

Category

Memory & Knowledge

License

MIT license

Transports

stdio

Author

MCP-Mirror

About Notion MCP Server

Mirror of

Notion MCP Server 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\" }"
      }
    }
  }
}

Notion MCP Server tools

24

Notion | Retrieve a user Error Responses: 400: 400

Notion | List all users Error Responses: 400: 400

Notion | Retrieve your token's bot user Error Responses: 400: Bad request

Notion | Search by title Error Responses: 400: Bad request

Notion | Retrieve block children Error Responses: 400: Bad request

Notion | Append block children Error Responses: 400: Bad request

Notion | Retrieve a block Error Responses: 400: Bad request

Notion | Update a block Error Responses: 400: Bad request

Notion | Delete a block Error Responses: 400: Bad request

Notion | Retrieve a page Error Responses: 400: Bad request

Notion | Update page properties Error Responses: 400: Bad request

Notion | Create a page Error Responses: 400: Bad request

Notion | Retrieve a page property item Error Responses: 400: Bad request

Notion | Retrieve comments Error Responses: 400: Bad request

Notion | Create comment Error Responses: 400: Bad request

Notion | Query a data source Error Responses: 400: Bad request

Notion | Retrieve a data source Error Responses: 400: Bad request

Notion | Update a data source Error Responses: 400: Bad request

Notion | Create a data source Error Responses: 400: Bad request

Notion | List templates in a data source Error Responses: 400: Bad request

Notion | Retrieve a database Error Responses: 400: Bad request

Notion | Move a page Error Responses: 400: Bad request

Notion | Retrieve a page as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 429: Rate limited.

Notion | Update a page's content as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 409: Conflict (e.g. row limit exceeded). 429: Rate limited.

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.

Frequently asked questions

1

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.

2

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.

3

What runtime dependencies are required?

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

4

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.

5

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

agentleFS

agentleFS

One permissioned folder your team and your AI agents both log into.

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.

Azquo

Azquo Holdings Ltd

Exact, shared memory for AI agents: a hierarchical database where totals always add up, every write is attributed to the agent and person behind it, and any figure traces back to its source file. Agents create databases,

Sensefold

SenseFold Labs

Personal context for every AI: search, read, and write back to your private Markdown library of articles, threads, PDFs, notes, and captured ChatGPT/Claude/Gemini/Grok conversations. Remote server, OAuth 2.1 paste-and-au

Context7 MCP - Up-to-date Docs For Any Cursor Prompt

upstash

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

58.7K
Advertise