Remembra Relay — Claude Code MCP server: features and setup
Passes Git state, test results, and unfinished work from one coding session to the next. Useful when a different agent or machine picks up the project.
claude mcp add --env REMEMBRA_API_KEY=<REMEMBRA_API_KEY> --env REMEMBRA_URL=<REMEMBRA_URL> --env REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> --transport stdio remembra-relay -- uvx remembra-mcpWhat Remembra Relay does
When a session ends, Relay gathers the branch, commits, changed files, and unpushed commits from Git. For Claude Code and Codex, it also reads commands and test runs from the local session transcript. Matching secrets are removed before transmission, and the transcript stays on your machine.
At the next session, the agent receives a short brief covering completed work, failures, and a next step. Browse the handoff history with remembra-relay trail or the Trail page in the dashboard. Setup requires a REMEMBRA_API_KEY and MCP configuration. Codex runs hooks only after you approve them; a changed hook command needs approval again.
The brief treats recorded details as untrusted data. Facts submitted by an agent through close_session are marked as unverified, and Relay does not validate their origin. Keep that distinction in mind when relying on an agent-reported handoff.
What it helps with
- carry Git state into the next agent session
- share test runs from Claude Code or Codex transcripts
- flag changed files and commits that have not been pushed
- review the handoff sequence across sessions
Example prompts for the agent
- Prepare a brief from the previous session with Remembra Relay before continuing the project.
- Close this session and pass the next agent the commit and test facts.
- Show the project handoff history with
remembra-relay trail.
How to install Remembra Relay
Platform CLI
claude mcp add --env REMEMBRA_API_KEY=<REMEMBRA_API_KEY> --env REMEMBRA_URL=<REMEMBRA_URL> --env REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> --transport stdio remembra-relay -- uvx remembra-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>
Platform CLI
codex mcp add remembra-relay --env REMEMBRA_API_KEY=<REMEMBRA_API_KEY> --env REMEMBRA_URL=<REMEMBRA_URL> --env REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> -- uvx remembra-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>
Config file
{
"mcpServers": {
"remembra-relay": {
"command": "uvx",
"args": [
"remembra-mcp"
],
"env": {
"REMEMBRA_API_KEY": "<REMEMBRA_API_KEY>",
"REMEMBRA_URL": "<REMEMBRA_URL>",
"REMEMBRA_AGENT_ID": "<REMEMBRA_AGENT_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>
Config file
{
"servers": {
"remembra-relay": {
"type": "stdio",
"command": "uvx",
"args": [
"remembra-mcp"
],
"env": {
"REMEMBRA_API_KEY": "<REMEMBRA_API_KEY>",
"REMEMBRA_URL": "<REMEMBRA_URL>",
"REMEMBRA_AGENT_ID": "<REMEMBRA_AGENT_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>
Platform CLI
gemini mcp add -e REMEMBRA_API_KEY=<REMEMBRA_API_KEY> -e REMEMBRA_URL=<REMEMBRA_URL> -e REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> remembra-relay uvx remembra-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Remembra Relay
How do I install Remembra Relay in Claude Code?
Add the server with claude mcp add remembra -e REMEMBRA_API_KEY=<REMEMBRA_API_KEY> -e REMEMBRA_URL=<REMEMBRA_URL> -- uvx remembra-mcp. Replace the placeholders with your key and server address.
What does Remembra Relay do?
It records session details and gives the next agent a brief on Git state, test results, and unfinished work.
What should I know about using Remembra Relay with Codex?
Codex hooks need approval in Hooks settings or through /hooks. Approve them again after a hook command changes.
