agent-recall — Claude Code MCP server: setup
agent-recall is a Claude Code MCP server that shares rules, corrections, and project state across connected agents. Each session starts with the same memory cards.
MIT ★ 376 updated 2026-11-16
claude mcp add --transport http agent-recall https://agentrecallx.com/mcpWhat agent-recall does
agent-recall keeps project rules, corrections, and current state in shared memory. When another agent connects, it receives the same cards at session start. The server can use a hosted endpoint or run locally with Markdown storage.
The hosted setup opens GitHub sign-in, and registration is free. The local option runs offline on the machine through one npx command; the README also lists optional hooks that automate the session loop.
What it helps with
- share a correction from one agent with every connected agent
- load project rules when a new session begins
- keep project state available across MCP clients
- store shared memory in local Markdown files
Example prompts for the agent
- Save this project rule with
/arsave: all API requests must go throughsrc/api/client.ts. - Search shared memory for the migration error using
/arrecall. - Start the session and load the project rules with
/arstart.
How to install agent-recall
1Platform CLI: remote server
claude mcp add --transport http agent-recall https://agentrecallx.com/mcp2Platform CLI
claude mcp add mcp-server -- npx -y agent-recall-mcp1Platform CLI: remote server
codex mcp add mcp-server --url https://agentrecallx.com/mcp2Platform CLI
codex mcp add mcp-server -- npx -y agent-recall-mcpConfig file
{
"mcpServers": {
"mcp-server": {
"url": "https://agentrecallx.com/mcp"
}
}
}{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"agent-recall-mcp"
]
}
}
}Config file
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://agentrecallx.com/mcp"
}
}
}{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-recall-mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http mcp-server https://agentrecallx.com/mcp2Platform CLI
gemini mcp add mcp-server npx -y agent-recall-mcpStep 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 agent-recall
How do I install agent-recall in Claude Code?
Run claude mcp add --transport http agent-recall https://agentrecallx.com/mcp. Claude Code then opens GitHub sign-in for the connection.
What does agent-recall do?
This MCP server keeps rules, corrections, and project state in shared memory. Connected agents receive the same cards when a session begins.
What does agent-recall need to work?
The hosted setup needs https://agentrecallx.com/mcp and GitHub sign-in. The local setup runs with npx -y agent-recall-mcp and stores data as Markdown on the machine.