Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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-mem
Open on GitHub

What 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-mem

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>

2Platform CLI: remote server

claude mcp add --transport http echo-memory https://api.echo-mem.com/mcp

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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open