Notion MCP Server

Name: Notion MCP Server
Author: Notion

NotionOfficial

Get started Repository

Official Notion server: search a workspace, read and edit pages as Markdown, and query and update data sources.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add notion --env OPENAPI_MCP_HEADERS='<OPENAPI_MCP_HEADERS>' --env NOTION_TOKEN='<NOTION_TOKEN>' --env NOTION_API_TOKEN='<NOTION_API_TOKEN>' -- npx -y @notionhq/notion-mcp-server

~/.codex/config.toml

[mcp_servers.notion]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
env = { OPENAPI_MCP_HEADERS = "<OPENAPI_MCP_HEADERS>", NOTION_TOKEN = "<NOTION_TOKEN>", NOTION_API_TOKEN = "<NOTION_API_TOKEN>" }

# codex mcp add notion --env OPENAPI_MCP_HEADERS='<OPENAPI_MCP_HEADERS>' --env NOTION_TOKEN='<NOTION_TOKEN>' --env NOTION_API_TOKEN='<NOTION_API_TOKEN>' -- npx -y @notionhq/notion-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "<OPENAPI_MCP_HEADERS>",
        "NOTION_TOKEN": "<NOTION_TOKEN>",
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "notion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "<OPENAPI_MCP_HEADERS>",
        "NOTION_TOKEN": "<NOTION_TOKEN>",
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "<OPENAPI_MCP_HEADERS>",
        "NOTION_TOKEN": "<NOTION_TOKEN>",
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "<OPENAPI_MCP_HEADERS>",
        "NOTION_TOKEN": "<NOTION_TOKEN>",
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "<OPENAPI_MCP_HEADERS>",
        "NOTION_TOKEN": "<NOTION_TOKEN>",
        "NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
      }
    }
  }
}

Environment variables

OPENAPI_MCP_HEADERS
NOTION_TOKEN
NOTION_API_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related