Using with Windsurf

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. codehub setup writes the entry for you.

Wire the MCP server

write Windsurf's MCP config

codehub setup --editors windsurf

The writer merges a codehub entry into the existing mcpServers object without touching other servers.

Prerequisite: codehub must be on your PATH — run mise run cli:link from a checkout, or mise run cli:install-global to install the packed tarball. See Install.

The entry uses the same shape as Claude Code and Cursor:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codehub": {
      "command": "codehub",
      "args": ["mcp"],
      "env": {}
    }
  }
}

Reload Windsurf after the first write so it picks up the new server. The server runs over stdio for the lifetime of the session.

Fallback for unlinked checkouts

If you cannot put codehub on PATH, point Windsurf at the CLI’s dist/ entrypoint instead — same behaviour, longer path:

~/.codeium/windsurf/mcp_config.json (fallback)

{
  "mcpServers": {
    "codehub": {
      "command": "node",
      "args": ["/abs/path/to/opencodehub/packages/cli/dist/index.js", "mcp"],
      "env": {}
    }
  }
}

Multi-editor setup

--editors accepts any comma-separated subset of claude-code,cursor,codex,windsurf,opencode. The default is all five.

wire Windsurf alongside Cursor

codehub setup --editors windsurf,cursor

Reverting

remove only the codehub entry

codehub setup --editors windsurf --undo

--undo removes only the codehub entry. Other Windsurf MCP servers are left alone.

Next

• MCP tools — the catalogue of 29 tools Windsurf will see.