Notion

by Notion

Repository Docs npm

Productivity

notionnotesdocsproductivityofficial

Summary

Notion's official MCP server — search, read, create, and update pages and databases in your workspace.

Features

Search the workspace
Read and create pages
Query and update databases
Comment on pages
Official Notion server

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Notion" tools will be available.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_YOUR_TOKEN\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add notion -e OPENAPI_MCP_HEADERS={"Authorization":"Bearer ntn_YOUR_TOKEN","Notion-Version":"2022-06-28"} -- npx -y @notionhq/notion-mcp-server

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_YOUR_TOKEN\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

Description

Notion's official MCP server. It exposes the Notion API to an agent so it can search the workspace, read and create pages, and query and update databases — letting assistants work directly with Notion content.