How do I set up the Notion MCP server?

Add the Notion server to your MCP config using the command: npx with the package @notionhq/notion-mcp-server. See the full config below.

What does the Notion MCP server do?

Search, read, and update Notion pages and databases. Uses OpenAI for semantic search.

Notion MCP Server — Config Template & Setup Guide

claude_desktop_config.json

{
  "mcpServers": {
    "server-notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`OPENAI_API_KEY`	✓ Required	OpenAI API key used by the Notion MCP server for semantic search functionality.

Setup Instructions

Ensure Node.js 18+ is installed on your system.
Copy the config block above into your claude_desktop_config.json file (typically at ~/.config/claude/claude_desktop_config.json on macOS/Linux or %APPDATA%\Claude\claude_desktop_config.json on Windows).
Set the OPENAI_API_KEY environment variable: OpenAI API key used by the Notion MCP server for semantic search functionality.
Restart your AI client to apply the config.