Notion MCP Server Cursor IDE Setup 2026

Notion is where specs, RFCs, meeting notes, and project context live for most engineering teams. Connecting it to Cursor via MCP means your AI assistant can read your actual docs — not hallucinate them. Here's the complete setup.

What This Integration Enables

With Notion MCP running in Cursor, you can:

Prerequisites

Step 1: Create a Notion Integration

1. Go to notion.so/my-integrations.
2. Click + New integration.
3. Name it "Cursor MCP", select your workspace, and enable: Read content, Update content, Insert content.
4. Click Save and copy the Internal Integration Secret (starts with secret_).

Step 2: Connect Pages to Your Integration

Notion integrations only see pages you explicitly share with them:

1. Open any Notion page you want accessible from Cursor.
2. Click ··· (three dots, top right) → Add connections.
3. Select your "Cursor MCP" integration.
4. Repeat for parent pages, databases, or workspaces — child pages are accessible automatically.

For maximum utility, connect your top-level workspace pages (e.g., Engineering Hub, Product Docs, Meeting Notes) so everything underneath is automatically accessible.

Step 3: Install the Notion MCP Server

Notion has an official package:

npm install -g @notionhq/mcp

Or run it without a global install:

npx @notionhq/mcp --version

Step 4: Configure Cursor

Edit ~/.cursor/mcp.json (macOS/Linux) or %APPDATA%\Cursor\mcp.json (Windows):

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/mcp"],
      "env": {
        "NOTION_API_TOKEN": "secret_your_token_here"
      }
    }
  }
}

Some versions require the API version header. If tools don't appear after setup, add:

"NOTION_VERSION": "2022-06-28"

Step 5: Restart and Verify

Quit Cursor fully and reopen. Check Settings → Features → MCP for the "notion" server.

Test in Composer:

Search Notion for "authentication architecture"

Getting results confirms the integration is working.

Real-World Use Cases

Retrieving a Spec While Coding

You're implementing a feature and need to check the original requirements:

Find the Notion page titled "User Authentication v2 Spec" 
and show me the API contract section

Creating Docs from Code

After implementing a module, generate documentation directly into Notion:

Create a new Notion page in the "Engineering Docs" database 
titled "Rate Limiting Implementation" and write a technical summary 
of how this middleware works: [paste code]

Querying a Database

List all items in the Notion "Q2 Roadmap" database 
where Status is "In Progress" and Team is "Backend"

Pulling Meeting Notes for Context

Find the most recent Notion page with "backend architecture" in the title 
from the last 2 weeks and summarize the key decisions

Appending to an Existing Page

Add a new section to the Notion page "Deployment Runbook" 
with the header "Emergency Rollback Procedure" and the following steps: 
[list your steps]

Troubleshooting

Token not working (401 error)

"Object not found" for specific pages

Search returns no results

Tools don't appear in Cursor after setup

Read-Only vs. Read-Write Setup

If you only want Cursor to read Notion (safer for shared workspaces), create the integration with only Read content permissions enabled. This prevents Cursor from accidentally creating or modifying pages.

For full read-write, enable all three content capabilities. You'll gain the ability to create pages and databases directly from Composer.

Combining Notion with Other MCP Servers

Notion works best as a context layer alongside action-oriented tools:

Example multi-server workflow:

1. Read the Notion page "Feature: Billing Overhaul Spec"
2. Create a Linear issue "Implement billing overhaul" with the spec summary
3. Create a GitHub branch "feature/billing-overhaul" in the payments repo

All from a single Composer prompt.

Security

More MCP Integrations

See the full MCP server directory to connect Slack, Linear, GitHub, Jira, and more to your Cursor workflow.