Skip to content
MCP server

Compound Memory

Local Markdown-and-git memory shared by several AI agents, exposed through five MCP tools

Runs locallyStatus and history
Install
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-memory

Add to claude_desktop_config.json

{
  "mcpServers": {
    "compound-memory": {
      "command": "uvx",
      "args": [
        "compound-memory"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "compound-memory": {
      "command": "uvx",
      "args": [
        "compound-memory"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/memory
  • COMPOUND_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.

How AIPoweredBot checks servers