Notion MCP Server

A maintained fork of the official Notion MCP server

Local serverstdioGo

What is the Notion MCP Server?

A maintained fork of the official Notion MCP server

What it actually does

If you have hardcoded tool names or prompts that reference the old database tools, update them to use the new data source tools:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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
post-database-queryreplaced by query-data-source
update-a-databasereplaced by update-a-data-source
create-a-databasereplaced by create-a-data-source
query-data-sourceQuery a data source (database) with filters and sorts
retrieve-a-data-sourceGet metadata and schema for a data source
update-a-data-sourceUpdate data source properties
create-a-data-sourceCreate a new data source
list-data-source-templatesList available templates in a data source
move-pageMove a page to a different parent location
retrieve-a-databaseGet database metadata including its data source IDs

How to install the Notion MCP Server

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
NOTION_TOKENCredential the server authenticates with.Yes
OPENAPI_MCP_HEADERSConfiguration value read at startup.Optional
AUTH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Notion to post-database-query.”
  • “Use Notion to update-a-database.”
  • “Use Notion to create-a-database.”

Frequently asked questions

A maintained fork of the official Notion MCP server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.