Skip to content
Windsurf (Devin)

Connect Windsurf to Relay

Give Windsurf a memory it shares with your other AIs. Plans, progress and reviews saved in Windsurf can be picked up by any of the 25 AI tools Relay works with, and the other way round. It takes about two minutes.

What you need
All plans, including Free
How it connects
One command or config entry (MCP)

1. Get your connection link

  1. Sign in to Relay with Google. It's free during the beta.
  2. Open Integrations, click Set up on Windsurf, then Generate connection URL. Copy it straight away: it's shown only once.
  3. Below, YOUR-KEY stands for your link. The dashboard shows the same steps with your link already filled in.

2. Add Relay to Windsurf

  1. Open %USERPROFILE%\.codeium\windsurf\mcp_config.json (or Windsurf Settings → Cascade → MCP → View raw config) and add:
    {
      "mcpServers": {
        "relay": {
          "serverUrl": "https://mcp.relaymemory.app/mcp/YOUR-KEY"
        }
      }
    }
  2. Click Refresh in Cascade's MCP panel; relay should list its tools.

3. Test it

Send this in Windsurf. It should answer from your Relay memory:

Show my handoff board from Relay.

Make it save on its own

  1. In a Windsurf session, send this once:
    In every conversation, store our work in Relay: save new plans, add progress updates as we go, and keep it up to date.
  2. Windsurf asks permission to use Relay. Choose Allow always, so it saves as you work. Deleting always asks you first.
  3. To keep it on in new sessions, add the same sentence to a rule in .windsurf/rules or your AGENTS.md.

Using Relay in Windsurf every day

  • Relay loads in every Cascade session. Check it in Cascade's MCP panel.
  • Approve Relay's tools when Cascade asks, or let them run automatically in Cascade's settings.
  • Make it automatic: add this line to a rule in .windsurf/rules or your AGENTS.md, and it checks Relay on its own.
    At the start of a task, check Relay for the latest plan for this project. When you finish, add a progress update to Relay.

Things to say in Windsurf:

Save this plan to Relay for the project "My project".
Pick up my latest plan from Relay and continue it.
Add a progress update to Relay for this work.
Review the latest work in Relay and add your review.
Remember in Relay that I prefer short answers.
What's waiting for me in Relay?
Windsurf uses Relay's cloud endpoint, so it works even when Relay isn't running on your PC. Windsurf uses "serverUrl" (Cursor uses "url"), so copy this exact snippet.

Connect Windsurf in two minutes

Sign in with Google, connect your first AI and save your first handoff in a few minutes.

Join the free beta