stdio productivityknowledge

Notion MCP Server

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

Generate config in Builder → View Docs ↗

Installation

npx -y @notionhq/notion-mcp-server

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.

Prerequisites

  • Node.js 18 or later
  • Required API keys — see the Environment Variables table above

Common Errors

  • Server not found / spawn error — ensure Node.js is on your PATH and the package is accessible via npx.
  • Permission denied — check that the path in args is readable by the process running your AI client.
  • Authentication failed — verify your API key is set correctly in the env block.