How to add Notion MCP Server to Windsurf

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

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

Windsurf 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

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Notion MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Notion MCP Server's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Notion MCP Server config there under the "mcpServers" key and restart the client.

Is Notion MCP Server safe to use with Windsurf?

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