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.
{
"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
| File | Notion is available |
|---|---|
~/.cursor/mcp.json | In every project you open |
.cursor/mcp.json in a project | Only in that project; safe to commit, because the file has just the URL |
Set it up step by step
- 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
notionalongside them insidemcpServers. - Step 2: Save. In Cursor's sidebar, open Customize and find Notion in the list of MCP servers.
- Step 3: Switch it on. Cursor opens Notion in your browser; choose the workspace and allow access.
- Step 4: Back in Cursor, Notion should show as connected with its tools.
- 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:
{
"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 see | What to do |
|---|---|
| Notion never appears under Customize | Check the JSON is valid and the key is exactly mcpServers, then restart Cursor. |
| Stuck on authenticating | Switch Notion off and on to clear the sign-in and try again, or use the bridge above. |
| A message about your organisation's policy | An Enterprise admin controls MCP access to the workspace. Ask them. |
| The agent cannot find a page you can see | Guests 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.