Notion Private API MCP

An unofficial Notion MCP server built on Notion's private API (token_v2). It gives Claude Desktop, Claude Code, Cursor and any other MCP client full read/write access to your entire Notion workspace…

Local serverstdioMIT

What is the Notion Private API MCP Server?

Notion Private API MCP is an MCP project maintained in the kirvigen/notion-private-api-mcp repository. The maintainer describes its purpose as “An unofficial Notion MCP server built on Notion's private API (token_v2). It gives Claude Desktop, Claude Code, Cursor and any other MCP client full read/write…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares NOTION_TOKEN_V2. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_pageRead a page block and its metadata
get_blockRead a single block
get_block_childrenRead the direct child blocks of a page or block
get_style_documentationCatalog of supported block types & inline annotations (call before composing complex pages)
markdown_to_blocksPreview how Markdown parses into the simplified block JSON
create_pageCreate a child page under another page, from blocks or Markdown
append_blocksAppend blocks/Markdown to a page (at the end, or after a given block)
replace_page_contentReplace the direct child blocks of a page
update_block_textReplace the plain-text content of a block (e.g. a code block)
delete_blocksRemove (archive) direct child blocks from a page
sync_markdown_fileCreate or replace a page from a local Markdown file

How to install the Notion Private API MCP Server

{
  "mcpServers": {
    "notion-private": {
      "command": "node",
      "args": [
        "/absolute/path/to/notion-private-api-mcp/src/server.js"
      ],
      "env": {
        "NOTION_TOKEN_V2": "YOUR_NOTION_TOKEN_V2"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
NOTION_TOKEN_V2Declared in the maintainer’s client configuration.Yes