Skip to content
Relay
AWS · IDE and CLI

Connect Kiro to Relay

Give Kiro a memory it shares with your other AIs. Plans, progress and reviews saved in Kiro 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 Kiro, 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 Kiro

Kiro IDE

  1. Press Ctrl+Shift+P (Cmd+Shift+P on Mac) and run Kiro: Open user MCP config (JSON), or click Open MCP Config in the Kiro panel. (The file is ~/.kiro/settings/mcp.json on Windows %USERPROFILE%\.kiro\settings\mcp.json.)
  2. Paste this. If the file already has other servers, add only the "relay" part:
    {
  "mcpServers": {
    "relay": {
      "url": "https://mcp.relaymemory.app/mcp/YOUR-KEY"
    }
  }
}
  3. Save. Kiro reconnects by itself. In the Kiro panel's MCP Servers list, relay should be connected.

Kiro CLI

  1. The Kiro CLI reads the same ~/.kiro/settings/mcp.json. Add the snippet above to it if you haven't.
  2. Start kiro-cli and run /mcp. relay should be listed.

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

Apps change their menus often. Paste this into Kiro (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 Kiro? Please give me short, exact step-by-step instructions for the current version of Kiro 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 Kiro can't add custom MCP servers on my account or version, tell me that plainly.

3. Test it

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

Pick up my latest plan from Relay.

Make it save on its own

  1. In a Kiro 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. Kiro 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 Kiro 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 Kiro:

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?
Kiro uses Relay's cloud endpoint, so it works even when Relay isn't running on your PC. Kiro is AWS's agentic IDE and CLI. It replaced the Amazon Q Developer CLI, so Amazon Q users can follow these steps.

Connect Kiro in two minutes

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

Join the free beta