Skip to content
Block · open source

Connect Goose to Relay

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

Goose Desktop

  1. Click the sidebar button (top left), then Extensions → Add custom extension.
  2. Set Type to Streamable HTTP and Extension Name to relay.
  3. Paste your connection link as the Endpoint, and leave Request Headers empty:
    https://mcp.relaymemory.app/mcp/YOUR-KEY
  4. Click Add Extension, then start a new session.

Goose CLI

  1. Run goose configure → Add Extension → Remote Extension (Streamable HTTP).
  2. Name it relay, paste your link as the URI, accept the timeout and description, and answer No to custom headers:
    https://mcp.relaymemory.app/mcp/YOUR-KEY
  3. Start a new session (goose session). Relay's tools should be available.

Remove Relay (or start over)

  1. Run goose configure → Remove Extension, select relay with Space, and press Enter. (In Desktop, turn the extension off first.)

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

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

3. Test it

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

Pick up my latest plan from Relay.

Make it save on its own

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

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?
Goose uses Relay's cloud endpoint, so it works even when Relay isn't running on your PC. Goose is a free, open-source agent (desktop and CLI) from the Agentic AI Foundation, started by Block. It uses the model you choose, including local ones.

Connect Goose in two minutes

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

Join the free beta