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

Data as of

Notion MCP Server for Cursor: Setup & Config

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

Notion MCP Server Cursor configuration

  1. Choose Cursor configuration scope

    For Notion MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

  2. Add Notion MCP Server to Cursor

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

  3. Check Notion MCP Server in Cursor

    Notion MCP Server: Enable in Cursor’s MCP settings; inspect tools.

Config file · Project: .cursor/mcp.json

User: ~/.cursor/mcp.json

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

Notion in Cursor: stdio checks

  • Cursor must find npx @notionhq/notion-mcp-server (Node.js/npm) for Notion MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
  • Review NOTION_TOKEN for Notion MCP Server before sharing project .cursor/mcp.json; project scope travels with the repository.
  • Notion MCP Server uses stdio here: Cursor 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. Cursor guide

Frequently asked questions

Cursor's Notion MCP Server entry belongs under mcpServers in .cursor/mcp.json (project) or ~/.cursor/mcp.json (user). Confirm the active scope in MCP settings.

Cursor's notion-mcp-server example uses stdio.

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

Cursor'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 Cursor's connected tool list; the stored list is not a live check.