Notion MCP Server for Cursor: Setup & Config

What you can do with Notion in Cursor

Pick it for compact Notion context and schema-aware editing without relying on raw API JSON for routine work.

• Locate pages and read compact content with stable block IDs
• Create data source items from simple property values
• Use interactive Notion exploration and editing apps

Before you start: Notion in Cursor

• npx
• An MCP host
• A Notion internal integration token
• Content shared with the integration and appropriate capabilities

Restart the MCP host after configuration. Grant only needed capabilities and share target pages or databases with the integration. Development prerequisites specify Node.js 22 or newer and pnpm.

Notion Cursor configuration

1. Choose Cursor configuration scope

   For Notion MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Notion MCP Server to Cursor

   Use the mcp-notion-server entry below in mcpServers. Keep Notion MCP Server's documented stdio connection fields and your other Cursor entries.

3. Check Notion MCP Server in Cursor

   Notion MCP Server: Enable in Cursor’s MCP settings; inspect tools.

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

Notion tools available to Cursor

Notion's stored tool list documents 31 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

notion_open_data_source_app

Find notion_open_data_source_app under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Open an interactive app for schema inspection, filtering, queries, and item creation.

notion_open_page_workbench

Find notion_open_page_workbench under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_append_block_children

Find notion_append_block_children under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_append_content

Find notion_append_content under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_append_markdown

Find notion_append_markdown under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_update_content

Find notion_update_content under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_update_content_batch

Find notion_update_content_batch under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_retrieve_block

Find notion_retrieve_block under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_retrieve_block_children

Find notion_retrieve_block_children under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_delete_block

Find notion_delete_block under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_update_block

Find notion_update_block under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_retrieve_page

Find notion_retrieve_page under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_read_page

Find notion_read_page under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_update_page_properties

Find notion_update_page_properties under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_list_all_users

Find notion_list_all_users under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_retrieve_user

Find notion_retrieve_user under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

notion_retrieve_bot_user

Find notion_retrieve_bot_user under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect the bot identity associated with the token.

notion_retrieve_database

Find notion_retrieve_database under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect a database container and discover its child data sources.

notion_create_database

Find notion_create_database under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Create a database and its initial data source schema.

notion_create_data_source

Find notion_create_data_source under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Add another data source to an existing database.

notion_query_data_source

Find notion_query_data_source under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Query a data source with filters, ordering, and pagination.

notion_query_data_source_by_values

Find notion_query_data_source_by_values under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Query using schema-aware simple filters and sort values.

notion_retrieve_data_source

Find notion_retrieve_data_source under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Fetch data source metadata and property definitions.

notion_update_data_source

Find notion_update_data_source under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Change a data source title, description, or schema.

notion_create_data_source_item

Find notion_create_data_source_item under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Create a page item using a data source as parent.

notion_create_data_source_item_from_values

Find notion_create_data_source_item_from_values under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Create an item by converting simple values against the data source schema.

notion_create_comment

Find notion_create_comment under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Add a comment to a page or discussion with the required integration capability.

notion_retrieve_comments

Find notion_retrieve_comments under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Read unresolved comments with the required comment capability.

notion_find

Find notion_find under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Discover candidate pages or data sources with compact results and suggested follow-up tools.

notion_inspect_data_source

Find notion_inspect_data_source under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Summarize schema properties, options, and relation targets for an agent.

notion_search

Find notion_search under Notion in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Search for pages or data sources by title.

Notion: full stored tool descriptions

Troubleshooting Notion in Cursor

• Cursor must find npx @suekou/mcp-notion-server (Node.js/npm) for Notion MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
• Review NOTION_API_TOKEN for Notion MCP Server before sharing project .cursor/mcp.json; project scope travels with the repository.
• Notion MCP Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Only shared content and granted capabilities are accessible
• Known limitation: Some user lookup tools require Enterprise and an Organization API key
• Known limitation: Markdown append supports a limited safe subset
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions