home / mcp / notion mcp server

Notion MCP Server

Official Notion MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "makenotion-notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_****",
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2025-09-03\" }"
      }
    }
  }
}

You can run and connect to the Notion MCP Server to access Notion pages and databases through automated AI workflows. This server provides data-source oriented capabilities that let your AI agents query, create, update, and organize content in Notion using MCP client tools, with secure token-based access and flexible transport options.

How to use

Learn to connect your MCP client to the Notion MCP Server and perform common actions such as querying data sources, retrieving schemas, moving pages, and managing data sources. You will operate through a local or remote MCP server process that exposes a set of tools your AI agent can call. Ensure your client is configured to use MCP with the appropriate token and transport mode.

How to install

Prerequisites: You need Node.js and npm installed on your system. You may also run the MCP server via Docker or through editor integrations that support MCP. Follow the installation flow that matches your preferred method.

Additional configuration and usage notes

Notion MCP supports multiple transport options and several ways to run the server locally or in a container. The following configuration examples show how to start the server with an access token and how to integrate it into your client setup.

Available tools

query-data-source

Query a data source with filters and sorts to retrieve matching records from a Notion data source.

retrieve-a-data-source

Get metadata and schema for a data source to understand its properties and structure.

update-a-data-source

Update data source properties, such as its name or access settings.

create-a-data-source

Create a new data source for accessing Notion databases or pages.

list-data-source-templates

List available templates within a data source to guide data organization.

move-page

Move a page to a different parent location within your Notion workspace.

retrieve-a-database

Get database metadata including the list of data source IDs.