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 Duplicate Supplier Invoice Check in Windsurf
Review supplied invoice history for repeated references, formatting variations and equal amount/date candidates.
MCP Three-Way Invoice Match in Windsurf
Compare supplier invoice lines with purchase orders and accepted receipt quantities by exact SKU.
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 Resume and Cover Letter in Windsurf
Resumes and cover letters as Word files, from one stored profile.
MCP Recurring Invoices in Windsurf
Retainers and subscriptions billed on a schedule you set once.
MCP Clause Library in Windsurf
Reusable contract clauses, searched and assembled into Word.
MCP Office Suite in Windsurf
One config entry that exposes every tool of all 41 sibling servers.
MCP PDF Tools in Windsurf
Merge, split, stamp and read PDFs, pure JavaScript, no upload.
MCP Calendar in Windsurf
Read .ics calendars: events, free and busy, conflicts, exports.
MCP Kanban in Windsurf
A task board per project that hands off to the time tracker.
MCP Image Tools in Windsurf
Resize, convert, compress and watermark images, pure JavaScript.
MCP Bank Statement in Windsurf
Bank CSV exports categorised, summarised and reconciled with expenses.
MCP Quotes in Windsurf
A priced, VAT-correct quote from chat, turned into an invoice with one call.
MCP Barcode in Windsurf
QR codes and barcodes drawn locally: SEPA payment codes, WiFi, vCard, Code 128, EAN-13.
MCP Billing Docs in Windsurf
Credit notes and purchase orders written against the invoices the invoice server already holds, with the VAT unwound at the rate you charged.
MCP Deposits in Windsurf
Security and retainer deposits held per client, applied to the invoices the invoice server already holds.
MCP Per Diem in Windsurf
Statutory travel allowances on the rate tables the tax authorities publish, and the trips you priced with them.
MCP Asset Register in Windsurf
A fixed asset register that depreciates on the rates the tax authorities actually publish, with the schedule, the journal and the gain on sale.
MCP Statement of Account in Windsurf
The one document that answers what a client actually owes you, aged as at any date you name, with the chaser drafted.
MCP Cash Book in Windsurf
One double-entry ledger derived from the books you already keep, proved to zero to the minor unit, with every line naming the document it came from.
MCP Amortization in Windsurf
Loan and lease schedules derived from the terms of the agreement, in integer minor units, closing exactly on the balloon or on zero.
MCP Work Order in Windsurf
Job orders for trades and field work: parts and labour as they happen, a status that moves one dated step at a time, a completion report, and an invoice payload that needs no retyping.
MCP Catalogue in Windsurf
One price list and one labour rate card, kept where the invoice and the quote can both read them, with the price on a date worked out on the call.
MCP Change Order in Windsurf
Change orders against a quote or a work order, with the running contract value built from what the client actually approved.
MCP Petty Cash in Windsurf
A petty cash float on the imprest system: vouchers out of the tin, a count that reconciles them to the minor unit, and the replenishment that puts the float back.
MCP Zip in Windsurf
Pack, list and unpack zip archives locally, with traversal, symlink and bomb guards read from the header before anything is inflated.
MCP Delivery Schedule in Windsurf
Dated deliverables against a quote, a work order or a change order, and what is late as at any date you name.
MCP Packing List in Windsurf
Packing slips that carry no prices: what is in each carton, what it weighs, and what is still to pack.
MCP Checklist in Windsurf
Checklists you build once and run many times, and the dated record of each run that somebody signs.
MCP Goods Receipt in Windsurf
Goods receipt notes against purchase orders: what arrived, what was damaged, what never came.
MCP Leave Tracker in Windsurf
Staff leave and PTO: requests, approvals, balances, who is out and a calendar export.
MCP Onboarding in Windsurf
New-hire onboarding plans: one hire at a time or a whole cohort from a role template.
MCP Backlink Checker in Windsurf
Check backlinks from a chat: does a page link to your domain, dofollow or nofollow, anchor text and robots guards.
MCP Purchase Requisition in Windsurf
Purchase requisitions you build once and run per order, with a signed record of each run.
MCP Bill of Sale in Windsurf
Record a sale of equipment, a vehicle or stock and get a printable bill of sale with signature lines.
MCP Credit Note in Windsurf
Credit notes against an invoice or standalone: drafts, finalization, rendering and totals, all in integer minor units.
MCP Job Card in Windsurf
One card per job: hours and materials logged against it, a status machine from open to invoiced, and the printed card for client sign-off.
MCP Dunning Letters in Windsurf
Chase overdue invoices on a ladder anchored to the due date: reminder 1, reminder 2, the final notice, with the aging and the day's chase list.
MCP Supplier List in Windsurf
A supplier directory that does not rot: contacts, terms, lead times, and when each record was last reviewed.
MCP Service Agreement in Windsurf
Service agreements for freelancers: scope, deliverables, rate, termination and liability, rendered for signing.
MCP Maintenance Log in Windsurf
Equipment maintenance log: assets, service entries with costs, and a due report computed from stored dates.
MCP Mileage Log in Windsurf
Mileage log for deductible driving: trips, effective-dated rates, summaries and CSV export.
MCP Pomodoro in Windsurf
Focus blocks planned in the chat you are already in.
MCP Budget in Windsurf
Monthly envelopes you set and check inside the conversation.
MCP Loan Calculator in Windsurf
Monthly payments and full amortization in one sentence.
MCP Payroll in Windsurf
Gross-to-net for hourly staff, computed in the conversation.
MCP Receipts in Windsurf
Turn receipt lines into an itemized, taxed total.
MCP Stripe Billing in Windsurf
Check your Stripe balance and build payment links from chat.
MCP Tax Calculator in Windsurf
2026 US federal brackets, computed in the conversation.
MCP Hourly Rate Calculator in Windsurf
Price your hours from income, expenses, and tax, with what-if scenarios.

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