MCP Directory

How to add Notion MCP Server to Cursor

AI-friendly MCP server for the Notion API — find, read, query, and update Notion workspaces with compact, agent-ready responses. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 907★ · stdio · apikey

Cursor config for Notion MCP Server

npx -y @suekou/mcp-notion-server
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Setup steps

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

Before you start

  • A Notion account with an internal integration created at the Notion integrations dashboard
  • A Notion integration token (NOTION_API_TOKEN) with the needed capabilities
  • Pages or databases shared with the integration via Content access / Connections
  • Node.js 22 or newer (for local builds); npx for the default install

What Notion MCP Server can do in Cursor

notion_find

Search Notion and discover the target page or data source to work with.

notion_read_page

Read a page compactly, returning page context and stable, editable block IDs.

notion_inspect_data_source

Inspect a data source's schema before querying or creating items.

notion_query_data_source_by_values

Schema-aware querying of a data source using simple values.

notion_create_data_source_item_from_values

Create a data source item from simple values.

notion_append_markdown

Safely append Markdown content to a page.

notion_append_content

Append content blocks (paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers) to a page.

notion_update_content

Update a page's content block.

Security

Requires a Notion internal integration token (NOTION_API_TOKEN). Notion only lets an integration access pages and databases explicitly shared with it, and a connection added to a page also grants access to that page's children. Grant only the integration capabilities (read/insert/update content, comments, user info) that you actually need.

Notion MCP Server + Cursor FAQ

Where is the Cursor config file?

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

Is Notion MCP Server safe to use with Cursor?

Requires a Notion internal integration token (NOTION_API_TOKEN). Notion only lets an integration access pages and databases explicitly shared with it, and a connection added to a page also grants access to that page's children. Grant only the integration capabilities (read/insert/update content, comments, user info) that you actually need.

How do I authenticate?

Create an internal Notion integration, copy its secret token, and set it as NOTION_API_TOKEN in your MCP host config. Notion only exposes pages and databases that have been explicitly shared with the integration.

Which Notion API version does it target?

It targets the Notion API 2026-03-11 and uses the current database/data source model.

Can I run a locally built checkout instead of npx?

Yes. Build the project with pnpm and point the config command to node with args ["/absolute/path/to/suekou-mcp-notion-server/build/index.js"], keeping NOTION_API_TOKEN in env.

View repo Full Notion MCP Server page