Notion MCP Server

Name: Notion MCP Server
Author: Notion

Notion官方

开始使用源码仓库

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

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 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>"
      }
    }
  }
}

需要的环境变量

OPENAPI_MCP_HEADERS
NOTION_TOKEN
NOTION_API_TOKEN

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐