Notion MCP Server: Install & Setup

Install Notion in Claude Code

npm

Claude Code

claude mcp add awkoy-notion -e NOTION_TOKEN=... -- npx -y notion-mcp-server

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "awkoy-notion": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add awkoy-notion -e NOTION_TOKEN=... -- docker run -i --rm -e NOTION_TOKEN ghcr.io/awkoy/notion-mcp-server:3.3.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "awkoy-notion": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NOTION_TOKEN",
        "ghcr.io/awkoy/notion-mcp-server:3.3.0"
      ],
      "env": {
        "NOTION_TOKEN": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Notion MCP server do?

Context-efficient Notion access: pages, databases, blocks, comments, files and templates through a minimal tool set, with token auth for headless use.

Is the Notion MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Notion run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Notion to Claude Code?

Run: claude mcp add awkoy-notion -e NOTION_TOKEN=... -- npx -y notion-mcp-server

More other tools & integrations MCP servers

View all

ProxmoxMCP-Plus

630

RekklesNA/ProxmoxMCP-Plus

Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.

LocalAccount needed

Wcgw

677

rusiaaman/wcgw

Autonomous shell execution, computer control and coding agent for Mac.

LocalFreePython

Open Design

618

feimacode/open-design-agent-kit

Design skills, design systems and artifact tools: landing pages, decks, prototypes, posters, more.

LocalFree

Photoshop

775

alisaitteke/photoshop-mcp

MCP server for Adobe Photoshop — 128 tools (generative AI + recipes), standalone web UI. Control Ph…

LocalFree

Homeassistant

576

tevonsb/homeassistant-mcp

Access Home Assistant data and control devices such as lights, switches and thermostats.

LocalFreeTypeScript

Docling

782

docling-project/docling-mcp

Convert PDFs and other documents to structured formats via Docling, for AI applications.

LocalFree