Connect Windsurf
How to connect Windsurf to email (send and reply via MCP)
Connect Windsurf to email by adding SendRaven to Cascade's MCP config with the server URL https://mcp.sendraven.ai/mcp, then refreshing the MCP panel.
Cascade can then send from your own domain, read replies as threads and answer them, under the limits of the key it connected with.
{
"mcpServers": {
"sendraven": {
"serverUrl": "https://mcp.sendraven.ai/mcp",
"headers": { "Authorization": "Bearer ${env:SENDRAVEN_API_KEY}" }
}
}
}> Read the latest reply from our beta tester and open an issue in this repo for each bug they mention.Before you start
What Windsurf needs.
Windsurf with Cascade. On a Teams or Enterprise plan an admin may have to allow MCP, or this server, first.
A SendRaven workspace with a verified sending domain and a payment method on it. Free includes 3,000 emails a month and is never charged without an upgrade.
An API key in an environment variable if Cascade should run under a key's limits.
Setup
Connect Windsurf step by step.
Open the MCP config
In Cascade, open the MCP menu and choose the option to open the MCP config file. Opening it from there finds the right file, whose location has moved between versions.
Add SendRaven
Cascade signs in through the browser when a tool first needs it. To use a key instead, add a headers entry reading it from the environment.
mcp_config.json{ "mcpServers": { "sendraven": { "serverUrl": "https://mcp.sendraven.ai/mcp", "headers": { "Authorization": "Bearer ${env:SENDRAVEN_API_KEY}" } } } }Refresh
Press refresh in the MCP panel. SendRaven appears with its tools, each of which can be switched off.
Try it
Three things to ask Windsurf.
“Read the latest reply from our beta tester and open an issue in this repo for each bug they mention.”
Reads the thread with get_thread, then works in the repository as Cascade normally does. Email becomes an input to the coding task.
“Email the team the list of files this refactor touched, from builds@mail.yourcompany.com.”
Sends with send_email from an address on your verified domain, built from the change Cascade just made.
“Is anything waiting on a reply from me today? Only list threads from customers.”
Filters list_threads with awaiting_reply and reads each with get_thread to tell customers from colleagues.
Once connected
What Windsurf can do with email.
Send
From your own verified domain, as plain text, HTML or a stored template, now or at a set time.
- send_email
- send_template_email
- list_scheduled_emails
Read the replies
Replies join the thread they answer on Message-ID, with the quoted history removed, and one call lists what is waiting on you.
- list_threads
- get_thread
- mark_thread_handled
Reply in the thread
The answer goes into the same conversation with the right headers, so it lands under the original in the recipient's inbox.
- reply_to_message
Run sequences and campaigns
Automations that stop when someone replies or unsubscribes, and campaigns that can be previewed before they go.
- create_automation
- enroll_in_automation
- preview_broadcast
Every tool the server has, grouped by what an agent is trying to do.
Safety controls
The limits live on the key, not in the prompt.
Windsurf reaches exactly what its credential can reach. Give an agent's API key any of these, and the tools respect them because the API underneath enforces them.
A daily send cap
daily_send_limit stops the key once it has sent that many today, counting scheduled and held mail too.
A recipient allowlist
allowed_recipients takes addresses and whole domains. Anything else is refused before it is written.
An approval hold
requires_approval turns every send into a draft that a person releases. The key cannot approve its own drafts.
A browser sign-in carries none of the three, so use a key for anything that runs unattended. A key also cannot raise its own limits: key management has no MCP tool. Every limit a key can carry.
Troubleshooting
If it does not work.
SendRaven does not appear after editing the config.
Press refresh in the MCP panel. If it still does not show, quit Windsurf fully and open it again.
The server is listed but blocked on a team plan.
An admin controls MCP in the team's settings, and once any server is allowlisted every other one is blocked. Ask them to add the SendRaven URL to the list.
Edits to ~/.codeium/windsurf/mcp_config.json have no effect.
Current versions read a different file. Open the config from Cascade's MCP menu, which always opens the one in use, and add the server there.
Why not just Resend?
Resend has an MCP server too. The difference is what happens after the send.
The reply is a thread, not a webhook
SendRaven: Joined on Message-ID to the message it answers. Resend: a received-email event; you fetch the message and set reply headers yourself.
Per-key daily cap and recipient allowlist
SendRaven: daily_send_limit and allowed_recipients on the key, checked on every send. Resend: keys scope to a domain and to send-only; no cap or allowlist.
Human approval hold on a key
SendRaven: requires_approval drafts the message and waits for a person. Resend: not offered.
From resend.com, last checked 16 September 2026. The full comparison, including where Resend is the better choice.
Questions
Can Windsurf send emails?
Yes, through an MCP server for an email service. With SendRaven added to Cascade's MCP config, Windsurf sends from your own verified domain, reads replies as threads and answers them.
Where is Windsurf's MCP config file?
Open it from Cascade's MCP menu rather than by path, because its location has changed between versions; the menu always opens the file Cascade reads.
Does Windsurf use serverUrl or url for a remote MCP server?
serverUrl is the documented key for a remote server in Windsurf's MCP config, and url is also accepted. Both take the full URL with its path.
Can I stop Cascade from emailing customers by mistake?
Yes. Connect it with an API key that has a recipient allowlist of your own domain, or an approval hold, and SendRaven refuses or holds anything outside it whatever Cascade is asked to do.

Give Windsurf an inbox it cannot misuse.
Verify a domain, create a key with the limits you want, and connect. Free includes 3,000 emails a month, inbound included, and is never charged without an upgrade.

