Home · Setup

MCP servers for Windsurf: install guides

Windsurf reads its MCP servers from mcp_config.json under the mcpServers key. The MCPs icon in the top right of the Cascade panel, or Devin Settings, Cascade, MCP Servers. The documentation for this file now lives under the Devin Desktop product name; the Windsurf docs URL redirects there. Save and reopen the MCP Servers list; Cascade picks it up without restarting the editor.

ScopePath
macOS, Windows and Linux~/.codeium/windsurf/mcp_config.json

The one thing that catches people out

Read this first: mcp_config.json applies to the legacy Cascade agent only. The Devin Local agent, the default for new tabs, takes its servers from the Devin CLI config files, so a correct entry here can still be invisible in a fresh tab. The other hard number is a cap: Cascade reaches at most 100 tools at once, and every enabled server spends from it.

Servers

MCP Time Tracker in Windsurf
Track billable time without leaving the chat.
MCP Price Tracker in Windsurf
Check and watch product prices on ordinary shop pages.
MCP Spreadsheet in Windsurf
Read, query, edit and convert xlsx and csv files safely.
MCP Invoice in Windsurf
Numbered invoices with tax lines, rendered to a PDF.
MCP Expense Tracker in Windsurf
Receipts, mileage and expenses that turn into invoice lines.
MCP Currency Converter in Windsurf
ECB reference rates with the rate date on every answer.
MCP Docx in Windsurf
Real Word documents from chat: proposals, contracts, quotes.
MCP Timezone Planner in Windsurf
Find meeting slots inside everyone's working hours.
MCP Office Suite in Windsurf
One config entry that exposes every tool of the five servers.

Each page carries the exact config entry, three prompts that were run against the server, and the hosted alternative that needs no install.

Other clients

VS Code · Cline · All clients · Guides · Windsurf MCP docs