Servers / Notion

Install Notion MCP in Cursor

Notion · Remote HTTP · OAuth

Cursor mcp.json

Paste this into ~/.cursor/mcp.json (global) or.cursor/mcp.json (this repo). Merge it with servers you already have. Primer: how Cursor loads MCP.

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

MCP endpoint: https://mcp.notion.com/mcp. Source: Notion MCP.

What it is

Notion MCP is the workspace, not a markdown dump. Specs, RFCs, and task databases live there. Cursor can query them instead of waiting for you to paste a page.

The problem it solves

If the spec is in Notion and the code is in git, the agent only sees git. That is how you get a feature that matches last week's export.

Install steps

1. Add the URL. Create a notion entry with url https://mcp.notion.com/mcp.
2. Connect the workspace. OAuth opens Notion. Grant only the pages the agent should see if Notion offers a picker.
3. Smoke test. Ask Cursor to find the page that describes this feature and quote the acceptance criteria.

A prompt that uses it

Search Notion for the spec of this feature, quote the acceptance criteria, and list the gaps in the current branch.

If it will not connect

If OAuth succeeds but search is empty, the integration cannot see those pages. Share them with the integration or reconnect with a wider grant. Confirm the URL is https://mcp.notion.com/mcp.

FAQ