1. Home
  2. Notion MCP Server
  3. Notion MCP Server for Claude Code: Setup & Config

Data as of

Notion MCP Server for Claude Code: Setup & Config

Connect Claude Code to the Notion API to work with pages and data sources.

Notion MCP Server Claude Code configuration

  1. Choose Claude Code configuration scope

    For Notion MCP Server, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add Notion MCP Server to Claude Code

    Use the notion-mcp-server entry below in mcpServers. Keep Notion MCP Server's documented stdio connection fields and your other Claude Code entries.

  3. Check Notion MCP Server in Claude Code

    Notion MCP Server: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

JSON
{
  "mcpServers": {
    "notion-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "<Notion internal integration token>"
      }
    }
  }
}

CLI (POSIX shell)
claude mcp add-json --scope project 'notion-mcp-server' '{"type":"stdio","command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"<Notion internal integration token>"}}'

Notion in Claude Code: stdio checks

  • If Notion MCP Server fails to start, check npx @notionhq/notion-mcp-server (Node.js/npm), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
  • Notion MCP Server: check NOTION_TOKEN; keep credentials out of shared .mcp.json.
  • Notion MCP Server uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
Tools
query-data-source, retrieve-a-data-source, update-a-data-source

Notion MCP Server — details. Claude Code guide

Frequently asked questions

Register Notion MCP Server with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's notion-mcp-server example uses stdio.

Notion MCP Server's Claude Code configuration invokes npx @notionhq/notion-mcp-server (Node.js/npm).

Claude Code's Notion MCP Server example references NOTION_TOKEN. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

Notion MCP Server's stored list contains 9 tools, including query-data-source, retrieve-a-data-source, update-a-data-source. Compare those names with Claude Code's connected tool list; the stored list is not a live check.