Home › Other › awkoy/notion-mcp-server

awkoy/notion-mcp-server

Token-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.

TypeScript Local macOSWindowsLinux

★ 180 stars Last pushed 2026-11-11 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 3.4.0)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "NOTION_TOKEN": "<YOUR_VALUE>"
      }
    }
  }
}

NOTION_TOKEN required secret — Notion Personal Access Token (ntn_...) or Internal Integration Secret. Create at https://app.notion.com/developers/tokens
NOTION_PAGE_ID — Optional default parent page ID used by create_page / create_database when no parent is passed.

Package (oci)

docker run -i --rm -e NOTION_TOKEN=<YOUR_VALUE> ghcr.io/awkoy/notion-mcp-server:3.4.0

Or add to your MCP client config:

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NOTION_TOKEN=<YOUR_VALUE>",
        "ghcr.io/awkoy/notion-mcp-server:3.4.0"
      ]
    }
  }
}

NOTION_TOKEN required secret — Notion Personal Access Token (ntn_...) or Internal Integration Secret. Create at https://app.notion.com/developers/tokens
NOTION_PAGE_ID — Optional default parent page ID used by create_page / create_database when no parent is passed.