How to add Notion MCP Server (official) to Cursor

Official Notion server to read, search, create, and update pages and databases in your workspace. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 3.9k★ · stdio · apikey · official

Cursor config for Notion MCP Server (official)

npx -y @notionhq/notion-mcp-server

{
  "mcpServers": {
    "notion-mcp-server-official": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "<your-notion-integration-token>"
      }
    }
  }
}

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Notion MCP Server (official) config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Notion MCP Server (official)'s tools to confirm it's connected.

Before you start

Node.js (a current LTS, Node 18+; run via npx without a global install)
A Notion internal integration token (an 'Internal Integration Secret') created at https://www.notion.so/profile/integrations
Each page/database the agent should touch must be shared with the integration (via the page's Connections menu or the integration's Access tab)
Optional: Docker if you prefer the mcp/notion image instead of npx

What Notion MCP Server (official) can do in Cursor

search

Search across pages and databases in the workspace

retrieve-a-page / create-a-page / update-a-page / move-page

Read, create, update, and move pages

query-data-source

Query a database/data source with filters and sorts

retrieve-a-data-source / create-a-data-source / update-a-data-source

Read and manage database (data source) schemas

retrieve-a-database

Retrieve a database object

append-block-children / retrieve-block-children

Read and append child blocks within a page

update-block / delete-a-block

Edit or delete individual content blocks

retrieve-comments / create-a-comment / update-a-comment / delete-a-comment

Read and manage page comments

Security

The integration token grants API access only to pages and databases you explicitly share with it, so scope access narrowly. Store NOTION_TOKEN as an env var, never in committed config.

Notion MCP Server (official) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Notion MCP Server (official) config there under the "mcpServers" key and restart the client.

Is Notion MCP Server (official) safe to use with Cursor?

The integration token grants API access only to pages and databases you explicitly share with it, so scope access narrowly. Store NOTION_TOKEN as an env var, never in committed config.

Why do the tools return nothing / 'object not found'?

The integration can only see pages and databases explicitly shared with it. Open the target page's Connections menu (or the integration's Access tab) and add the integration.

How do I provide the token?

Set the NOTION_TOKEN environment variable to your integration's internal secret (recommended). An advanced OPENAPI_MCP_HEADERS variable also exists for passing custom Authorization and Notion-Version headers.

Is there a hosted/remote version?

Yes. Notion offers a remote MCP server at mcp.notion.com with OAuth-based setup and Notion-optimized tools; Notion is prioritizing it and may reduce support for this local repo.

View repo Full Notion MCP Server (official) page