Echo Memory — Claude Code MCP server: what it does, how to install
Echo Memory is an MCP server for Claude Code and other agents that stores shared memory as a fact graph in Postgres. One agent's records become available to others without a model call.
no license ★ 2 updated 2026-10-22
claude mcp add echo-mem -e ECHO_MEMORY_DATABASE_URL=<ECHO_MEMORY_DATABASE_URL> -e ECHO_MEMORY_USER_ID=<ECHO_MEMORY_USER_ID> -e ECHO_MEMORY_AGENT_ID=<ECHO_MEMORY_AGENT_ID> -- uvx echo-memWhat Echo Memory does
The server stores facts as graph edges between entities: two agents who never worked together resolve names to the same entity and see what the other learned. Every fact carries metadata about who wrote it and when; writes never invoke a model. Hybrid search (vector + BM25) returns a ranked list with relevance scores and an explanation of which channels matched each fact.
Runs either via Docker with your own Postgres database or via the hosted service at https://api.echo-mem.com/mcp with no database to manage. Requires Python 3.11+ and environment variables ECHO_MEMORY_DATABASE_URL, ECHO_MEMORY_USER_ID, ECHO_MEMORY_AGENT_ID.
Seven tools: write_episode stores facts with no model call, query_memory searches by question and timestamp as_of, trace_cause builds causal chains through entities, get_audit_log shows change history. The echo-memory health command scores your store and suggests what to improve.
What it helps with
- persist facts across sessions of different agents
- search for relevant records by natural language question
- resolve entity names into a single graph without duplicates
- trace who wrote a fact and when
Example prompts for the agent
- Record that billing uses Razorpay, not Stripe
- Show all facts about the payment module from last week
- Trace the causal chain for why performance dropped
How to install Echo Memory
1Platform CLI
claude mcp add echo-mem -e ECHO_MEMORY_DATABASE_URL=<ECHO_MEMORY_DATABASE_URL> -e ECHO_MEMORY_USER_ID=<ECHO_MEMORY_USER_ID> -e ECHO_MEMORY_AGENT_ID=<ECHO_MEMORY_AGENT_ID> -- uvx echo-memReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from echo-mem <command>
2Platform CLI: remote server
claude mcp add --transport http echo-memory https://api.echo-mem.com/mcp1Platform CLI: remote server
codex mcp add echo-memory --url https://api.echo-mem.com/mcp2Platform CLI
codex mcp add echo-memory --env ECHO_MEMORY_DATABASE_URL=<ECHO_MEMORY_DATABASE_URL> --env ECHO_MEMORY_USER_ID=<ECHO_MEMORY_USER_ID> --env ECHO_MEMORY_AGENT_ID=<ECHO_MEMORY_AGENT_ID> -- uvx echo-memReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from echo-mem <command>
Config file
{
"mcpServers": {
"echo-memory": {
"url": "https://api.echo-mem.com/mcp"
}
}
}{
"mcpServers": {
"echo-memory": {
"command": "uvx",
"args": [
"echo-mem"
],
"env": {
"ECHO_MEMORY_DATABASE_URL": "<ECHO_MEMORY_DATABASE_URL>",
"ECHO_MEMORY_USER_ID": "<ECHO_MEMORY_USER_ID>",
"ECHO_MEMORY_AGENT_ID": "<ECHO_MEMORY_AGENT_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from echo-mem <command>
Config file
{
"servers": {
"echo-memory": {
"type": "http",
"url": "https://api.echo-mem.com/mcp"
}
}
}{
"servers": {
"echo-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"echo-mem"
],
"env": {
"ECHO_MEMORY_DATABASE_URL": "<ECHO_MEMORY_DATABASE_URL>",
"ECHO_MEMORY_USER_ID": "<ECHO_MEMORY_USER_ID>",
"ECHO_MEMORY_AGENT_ID": "<ECHO_MEMORY_AGENT_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from echo-mem <command>
1Platform CLI: remote server
gemini mcp add -t http echo-memory https://api.echo-mem.com/mcp2Platform CLI
gemini mcp add -e ECHO_MEMORY_DATABASE_URL=<ECHO_MEMORY_DATABASE_URL> -e ECHO_MEMORY_USER_ID=<ECHO_MEMORY_USER_ID> -e ECHO_MEMORY_AGENT_ID=<ECHO_MEMORY_AGENT_ID> echo-memory uvx echo-memReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from echo-mem <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 Echo Memory
How to install Echo Memory in Claude Code?
First pipx install echo-mem, then echo-memory quickstart to start the database, then run the claude mcp add command the script prints with the actual port and environment variables.
What does Echo Memory do?
Stores facts as a graph: one agent writes connections between entities, and other agents read them later. Writes do not call a model; search uses a hybrid index.
Do I need my own database for Echo Memory?
No, you can use the hosted service at https://api.echo-mem.com/mcp and pass a key to echo-memory connect. For your own database, Docker and Postgres are required.