Skip to content
Relay
Warp · terminal

Connect Warp to Relay

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

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. Click Connect an AI, pick Warp, then Create my connection link. 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 Warp

  1. In Warp, open Settings → Agents → MCP servers (or the Command Palette → Open MCP Servers) and click + Add.
  2. Paste this:
    {
  "mcpServers": {
    "relay": {
      "url": "https://mcp.relaymemory.app/mcp/YOUR-KEY"
    }
  }
}
  3. Save. relay should show as running. Use it from Warp's agent.

Can't find a button or option? Ask Warp itself

Apps change their menus often. Paste this into Warp (with your own link instead of YOUR-KEY), and it will walk you through its current screens.

How do I add a custom MCP server to Warp? Please give me short, exact step-by-step instructions for the current version of Warp that I'm using: where to click, which options to choose, and where to paste the server address.

The server is called "Relay". It is a remote MCP server using Streamable HTTP, at this address:
https://mcp.relaymemory.app/mcp/YOUR-KEY

It needs no sign-in: no OAuth, no API key and no headers (the key is part of the address).
If Warp can't add custom MCP servers on my account or version, tell me that plainly.

3. Test it

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

What's waiting for me in Relay?

Make it save on its own

  1. In a Warp 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. Warp 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 your project's instructions file (for example AGENTS.md).

Using Relay in Warp every day

  • Once added, Relay loads in every session. There's nothing to switch on.
  • When it asks to run a Relay tool, approve it. Most tools let you always allow it, so it stops asking.
  • Make it automatic: add this line to your project's instructions file (for example 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 Warp:

Save this plan to Relay for the project "My project".
Pick up my latest plan from Relay and continue it.
Save this to Relay with every decision and its reason, and what we tried that didn't work and why.
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?
Warp uses Relay's cloud endpoint, so it works even when Relay isn't running on your PC. Use Relay from Warp's agent.

Connect Warp in two minutes

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

Join the free beta