Skip to content
MCP Shelf

Pod to App: Cursor

How to install the Notion MCP server in Cursor

By Sophie Filer · Updated 10 Nov 2026 · Steps checked against Notion's own docs on 10 Nov 2026

The short answer

Put a notion entry with the URL https://mcp.notion.com/mcp in your Cursor mcp.json, then open Customize in the sidebar, switch Notion on and sign in. No integration token or npm package is needed.

~/.cursor/mcp.json
{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
File
~/.cursor/mcp.json
Sign-in
OAuth in the browser
Who can connect
Workspace members
Price
Free to connect

Pick the file

FileNotion is available
~/.cursor/mcp.jsonIn every project you open
.cursor/mcp.json in a projectOnly in that project; safe to commit, because the file has just the URL

Set it up step by step

  1. Step 1: Open the file you chose (create it if needed) and add the block from the top of this page. If other servers are there, put notion alongside them inside mcpServers.
  2. Step 2: Save. In Cursor's sidebar, open Customize and find Notion in the list of MCP servers.
  3. Step 3: Switch it on. Cursor opens Notion in your browser; choose the workspace and allow access.
  4. Step 4: Back in Cursor, Notion should show as connected with its tools.
  5. Step 5: Open an Agent chat and ask: "Read the API design page in Notion and check this endpoint matches it."

Good jobs for Notion in Cursor

  • Read the spec or ticket for the feature before the agent writes code.
  • Compare what was built with the acceptance list on the page, and list what is missing.
  • Write release notes or a short changelog straight into a Notion database.
  • Move the task to Done when the work is merged.

When the sign-in will not finish

Some setups block the direct connection or the browser hand-off. Notion's fallback is a small bridge that runs locally and talks to the hosted server for you:

~/.cursor/mcp.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
    }
  }
}

It needs Node.js installed. The sign-in still happens in your browser, just started by the bridge.

Troubleshooting

What you seeWhat to do
Notion never appears under CustomizeCheck the JSON is valid and the key is exactly mcpServers, then restart Cursor.
Stuck on authenticatingSwitch Notion off and on to clear the sign-in and try again, or use the bridge above.
A message about your organisation's policyAn Enterprise admin controls MCP access to the workspace. Ask them.
The agent cannot find a page you can seeGuests cannot connect. As a member, share the page with yourself or paste its link.

MCP Shelf take

Is Notion worth adding to Cursor?

If your specs, tickets or docs live in Notion, connecting it to Cursor removes the copy-paste step that usually goes wrong: the agent reads the actual page, not your summary of it. The setup takes a minute because it is a hosted server with browser sign-in. It is not worth it if Notion is only your personal notes, or if your team plans work somewhere else. Keep the agent pointed at specific pages, and treat writes back to Notion as drafts you glance over.

Sophie Filer

Questions

Does Cursor need a Notion integration token?

No. The hosted server uses OAuth: you sign in once in the browser. Business and Enterprise owners can create MCP tokens for setups with no browser, but Cursor does not need one.

Can I commit the Notion config to my repo?

Yes. With the hosted server, .cursor/mcp.json holds only the URL, and each teammate signs in with their own Notion account.

Why does Cursor show an old Notion setup with an API key?

Older guides used the local npm server with an internal integration secret. Notion no longer actively maintains it, so replace that entry with the hosted URL.

Sources: the steps on this page are written in our own words from Notion's own install docs, the README. If they disagree with this page, the project's docs win; please tell us from the server page.