How to install Serena MCP: the IDE for your agent in Windsurf
To install Serena MCP: the IDE for your agent in Windsurf, paste the "serena-mcp-the-ide-for-your-agent" block into ~/.codeium/windsurf/mcp_config.json and refresh the MCP panel in Cascade.
Built from the published package · server updated 2 days ago
- 1
Open the MCP config
In Windsurf, open Settings, then Cascade, then MCP servers, and choose to view the raw config.
- 2
Add the server
Paste this into mcp_config.json:
{ "mcpServers": { "serena-mcp-the-ide-for-your-agent": { "command": "uvx", "args": [ "serena-agent" ] } } } - 3
Refresh
Click refresh in the MCP panel. The server and its tools appear in Cascade.
Config file: ~/.codeium/windsurf/mcp_config.json
MCP servers run with your permissions. If Serena MCP: the IDE for your agent needs an API key, add it under env in the config. Check its README.
Install Serena MCP: the IDE for your agent in another app
Similar servers
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Codebase intelligence for AI coding agents — graph, git history, docs, decisions, code health.
Questions
Does Serena MCP: the IDE for your agent work in Windsurf?
Yes. Windsurf supports local and remote mcp servers, and Serena MCP: the IDE for your agent installs with the steps above.
Serena MCP: the IDE for your agent does not show up in Windsurf. What now?
Restart Windsurf fully, check the JSON is valid, and make sure uv (for uvx) is installed. See common MCP errors and fixes.
Is Serena MCP: the IDE for your agent safe?
It scores 88 of 100. Review the code before you install it, and only give it the access it needs. Grades and details.
