Compound Memory
Local Markdown-and-git memory shared by several AI agents, exposed through five MCP tools
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.5.12
- Listing updated
- today
Similar MCP servers
About Compound Memory
Compound Memory is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Memories are plain Markdown files with frontmatter, stored on your own disk and committed to a local git history on every write. The idea is that they strengthen with confirmed use, fade into a revivable archive when ignored, and get merged by distillation into fewer, denser entries.
The MCP surface is deliberately small: memory_write, memory_search, memory_get, memory_link and memory_feedback. A shared namespace is readable by every host, while each agent keeps a private agent-* namespace. Setting COMPOUND_MEMORY_AGENT_ID is required for multi-agent stores so identity comes from the process, not from what the model claims, and validation from a different host counts as independent evidence.
Search is lexical by default, with optional vector recall through sqlite-vec and BGE embeddings that falls back gracefully. It installs from PyPI via uvx, needs Python 3.11 or later, and has plugins for Claude Code, WorkBuddy/CodeBuddy and ZCode.
Install
Run in a terminal
claude mcp add compound-memory -- uvx compound-memoryAdd to claude_desktop_config.json
{
"mcpServers": {
"compound-memory": {
"command": "uvx",
"args": [
"compound-memory"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"compound-memory": {
"command": "uvx",
"args": [
"compound-memory"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"compound-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"compound-memory"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"compound-memory": {
"command": "uvx",
"args": [
"compound-memory"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"compound-memory": {
"command": "uvx",
"args": [
"compound-memory"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
COMPOUND_MEMORY_ROOTStore root directory. A leading ~ or $HOME/${HOME} is expanded; unset or blank falls back to $HOME/.agents/memoryCOMPOUND_MEMORY_AGENT_IDStable host agent id (e.g. agent-claude). Required for a multi-agent store: process identity wins over a self-reported source. Unset is only for a single trusted caller; stats.attestation.warning and the server log say so
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- memory_write
- Write a memory to the store.
- memory_search
- Search memories and return hits.
- memory_get
- Fetch a specific memory.
- memory_link
- Link related memories.
- memory_feedback
- Record feedback that confirms or disputes a memory.
What it does
- Five-tool surface
- write, search, get, link and feedback cover all reads and writes.
- Plain Markdown storage
- Human-readable files with git auto-commit on each write.
- Compounding recall
- Confirmed use raises confidence; neglected memories decay into an archive.
- Per-host namespaces
- A shared space plus private agent namespaces, with host-attested identity.
- Optional vector search
- Semantic recall with automatic fallback to lexical search.
- Host plugins
- Packaged for Claude Code, WorkBuddy/CodeBuddy and ZCode.
Good for
- Share project conventions across several coding agents
- Stop re-asking the same preferences each session
- Keep an auditable git history of agent memory
- Cross-validate memories between different agent hosts
Pricing
Open source
Free; local-first
Compound Memory FAQ
Does any data leave my machine?
The README describes it as local-first: nothing leaves your machine, and memory lives in Markdown files on disk.
Where is the store?
By default ~/.agents/memory, changeable with COMPOUND_MEMORY_ROOT.
Why set COMPOUND_MEMORY_AGENT_ID?
It is required for a multi-agent store so a forged source cannot write another host's namespace.
What does it require?
Python 3.11 or later and uv; the server launches with uvx from PyPI.
Is Compound Memory free?
Yes. Compound Memory is open source, so you can use and self-host it for free.
How do I add Compound Memory to Claude Code?
Run this command in your terminal: claude mcp add compound-memory -- uvx compound-memory
What are the best alternatives to Compound Memory?
The closest alternatives to Compound Memory are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


