Skip to content

Connect Notion (MCP token) to Cursor

Notion's hosted MCP server, reached with a token instead of a browser sign-in, so agents can connect with nobody there to approve it. Needs a Business or Enterprise plan.

MCP serverOfficialChecked 2026-11-16

Before you start

  • Cursor installed (see its MCP documentation (opens in a new tab)).
  • Notion (MCP token) is available on macOS, Windows, Linux and the web.
  • Only workspace owners on Business and Enterprise plans can create a token, with New MCP token in Notion's Developer portal. Set it as NOTION_MCP_TOKEN in your environment. On other plans, use the Notion entry, which signs in through your browser.
  1. Step 1: Add Notion (MCP token) to Cursor

    Install in one click

    Opens Cursor and asks you to confirm the server.

    Or add it to the project

    Add this to .cursor/mcp.json, or to ~/.cursor/mcp.json to use it in every project.

    .cursor/mcp.json
    {
      "mcpServers": {
        "notion-token": {
          "url": "https://mcp.notion.com/mcp",
          "headers": {
            "Authorization": "Bearer ${env:NOTION_MCP_TOKEN}"
          }
        }
      }
    }
    Good to know
    • Cursor reads NOTION_MCP_TOKEN when it starts. Set the variable, then open Cursor from that terminal so it can see it.
  2. Step 2: Check it's connected

    Open Cursor Settings, find the MCP section and check the server is enabled with its tools listed.

  3. Step 3: Try a first request

    Ask Cursor something that only works with Notion (MCP token) connected:

    Say to Cursor
    Find the Notion database that tracks our design tasks and list what's due this week.

If it doesn't work

  • Project servers live in .cursor/mcp.json; servers for every project live in ~/.cursor/mcp.json.
  • After editing the file by hand, toggle the server off and on in settings, or restart Cursor.
  • The Output panel (MCP Logs) shows why a server failed to start.