Notion MCP Server

A Model Context Protocol (MCP) server for interacting with Notion APIs.

Local serverstdio

What is the Notion MCP Server?

Notion MCP Server is an MCP project maintained in the flyer103/notion-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for interacting with Notion APIs”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /ABSOLUTE/PATH/TO/YOUR/uv. 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_API_KEY. 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_pageGet a Notion page by ID
update_pageUpdate a Notion page's properties
create_pageCreate a new Notion page
get_databaseGet a Notion database by ID
query_databaseQuery a Notion database
create_databaseCreate a new Notion database
update_databaseUpdate a Notion database
get_blockGet a Notion block by ID
update_blockUpdate a Notion block's content
list_blocksList a block's children
append_blocksAppend blocks to a block's children
delete_blockDelete a Notion block
create_commentCreate a new Notion comment
get_commentGet a Notion comment by ID
searchSearch for Notion objects

How to install the Notion MCP Server

{
  "mcpServers": {
    "notion-mcp": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/YOUR/notion-mcp",
        "run",
        "-m",
        "notion_mcp.server"
      ],
      "env": {
        "NOTION_API_KEY": "YOUR_NOTION_API_KEY"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
NOTION_API_KEYDeclared in the maintainer’s client configuration.Check documentation