Notion MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor
• VS Code / Cline

Installation Command

npx -y @notionhq/notion-mcp-server

Configuration Example

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

Environment variable required：OPENAPI_MCP_HEADERS。Do not commit these values to public repositories.

Permission Scope & Security Notes

可读写 Notion 页面，建议只授权特定页面的 Integration

• network-access
• credential-required

Risk Score：4/10

Common Errors

unauthorized

确认 Integration Token 有效且已连接到目标页面

object_not_found

确认 Integration 已被添加到目标页面或数据库

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools