How to Connect Notion Remote MCP to Windsurf

Add Notion Labs's remote MCP server to Windsurf in about a minute.

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1·https://mcp.notion.com/mcp

Step-by-step

Edit mcp_config.json
Add the serverUrl config above to ~/.codeium/windsurf/mcp_config.json and refresh in Cascade.
Authorize
On first use your client opens a Notion Labs OAuth consent screen — approve it and tools become available.
Verify
Verify in the browser: paste https://mcp.notion.com/mcp into remotemcp.net/inspector and run initialize + tools/list.

Troubleshooting OAuth / 401

A 401 Unauthorized on first connect is normal — the endpoint is OAuth-protected; let Windsurf finish the browser consent flow.
If the consent window never opens, remove and re-add the server, then retry.
Check the exact challenge at our OAuth debugger.
Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.

HTTP + SSEhttps://mcp.notion.com/mcp

Legacy SSE endpoint

SSEhttps://mcp.notion.com/sse

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "notion": {
      "serverUrl": "https://mcp.notion.com/mcp"
    }
  }
}

🔬 Test Live in Online Inspector 🔐 Audit OAuth 2.1 Config

Tools exposed by Notion MCP (5)

Tool	Safety	Description	Parameters
notion_search	🟢 Read	Search pages and databases across your Notion workspace.	query*: stringfilter: string
notion_retrieve_page	🟢 Read	Retrieve a Notion page's properties and content.	pageId*: string
notion_create_page	🟠 Write	Create a new page under a parent page or database.	parentId: stringtitle: stringcontent: string
notion_append_block_children	🟠 Write	Append blocks (paragraphs, todos, headings) to a Notion page.	blockId: stringchildren: array
notion_query_database	🟢 Read	Query a Notion database with filters and sorts.	databaseId*: stringfilter: objectsorts: array

Connect Notion MCP to another client

Other servers for Windsurf

GitHub MCPGitHub

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.15 toolsOnline232ms

Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.14 toolsOnline7ms

Figma Dev Mode MCPFigma

Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.

https://mcp.figma.com/mcp

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.14 toolsOnline42ms

Stripe MCPStripe

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.15 toolsOnline62ms

Cloudflare Docs MCPCloudflare

Cloudflare's free, authless documentation MCP server. Agents can search the full Cloudflare docs corpus — no account or token required.

https://docs.mcp.cloudflare.com/mcp

🛡️ Official✓ VerifiedHTTP + SSEPublic · No Auth2 toolsOnline10ms

DeepWiki MCPCognition AI (Devin)

Cognition Devin's free DeepWiki MCP. Ask questions and read AI-generated wiki documentation for any public GitHub repository — no auth required.

https://mcp.deepwiki.com/mcp

🧑‍💻 Community✓ VerifiedHTTP + SSEPublic · No Auth3 toolsOnline73ms