Connect MemoryCode to Windsurf (MCP)

Windsurf (Codeium) reads MCP servers from a JSON config file. After you add MemoryCode, Cascade can use the same tools as other MCP-aware clients, subject to Windsurf's own limits and startup behavior.

Before you start

Node.js 18+ and a valid export path for memorycode-mcp.json.
Patience on first npx run: downloading the package can take a minute or two.
If UI differs from this guide, follow Windsurf's MCP documentation.

Config file location

macOS / Linux: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Add the server entry

Merge the MemoryCode block into the MCP servers section Windsurf expects (often mcpServers). Replace the file path with your absolute path:

{
  "mcpServers": {
    "memorycode": {
  "command": "npx",
  "args": [
    "-y",
    "@memorycode/mcp-server",
    "--file",
    "/absolute/path/to/memorycode-mcp.json"
  ]
}
  }
}

Restart and verify

Quit and reopen Windsurf.
Check Cascade / MCP settings for server status.
If you see initialization timeouts, inspect MCP logs and network access to npm; as a next step, consider the local node + dist/index.js fallback described in the full manual.
Windsurf may enforce a tool limit across servers. If MemoryCode does not appear, try disabling other MCP servers temporarily.

Full reference

Windsurf-specific troubleshooting and copy-paste paths.

Open MCP setup guide →

← Back to MemoryCode