How to Install Notion MCP Server in Windsurf
Read, write, and search your Notion workspace — databases, pages, and knowledge base
What Notion MCP Server does
Connect your AI agent to Notion for full workspace access. Create and update pages, query databases, search across your knowledge base, and manage your team's documentation through natural language. Features: - Create, read, update, and delete Notion pages - Query and filter Notion databases - Workspace-wide full-text search - Add blocks to pages (text, lists, code, tables, callouts) - Manage database properties and schema - Handle nested pages and block hierarchies - Read and create comments - Access shared pages and team spaces This is one of the most popular productivity MCP servers — with 2,500+ GitHub stars — because Notion is where most teams store their knowledge, and having AI natively access it transforms how teams work. Requirements: - Notion Integration Token (create at notion.so/my-integrations) - The integration must be added to the pages/databases you want to access
Installation steps
- 1Copy the config below
- 2Open ~/.codeium/windsurf/mcp_config.json
- 3Paste inside "mcpServers": {}
- 4Restart Windsurf
Configuration
File location: ~/.codeium/windsurf/mcp_config.json
{
"notionMcpServer": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_API_TOKEN": "secret_..."
}
}
}Install in other clients
For maintainers
If you maintain Notion MCP Server, add this badge to your README to show it's verified on CuratedMCP:
[](https://curatedmcp.com/marketplace/notion-mcp-server)