Local-first shared memory for multiple AI agents that compounds with use; Markdown + git, MCP + CLI.
Connect Runs on your machine
claude mcp add compound-memory -e COMPOUND_MEMORY_ROOT=<COMPOUND_MEMORY_ROOT> -e COMPOUND_MEMORY_AGENT_ID=<COMPOUND_MEMORY_AGENT_ID> -- uvx compound-memory==0.5.12
{
"mcpServers": {
"compound-memory": {
"command": "uvx",
"args": [
"compound-memory==0.5.12"
],
"env": {
"COMPOUND_MEMORY_ROOT": "<COMPOUND_MEMORY_ROOT>",
"COMPOUND_MEMORY_AGENT_ID": "<COMPOUND_MEMORY_AGENT_ID>"
}
}
}
}
{
"mcpServers": {
"compound-memory": {
"command": "uvx",
"args": [
"compound-memory==0.5.12"
],
"env": {
"COMPOUND_MEMORY_ROOT": "<COMPOUND_MEMORY_ROOT>",
"COMPOUND_MEMORY_AGENT_ID": "<COMPOUND_MEMORY_AGENT_ID>"
}
}
}
}
{
"servers": {
"compound-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"compound-memory==0.5.12"
],
"env": {
"COMPOUND_MEMORY_ROOT": "<COMPOUND_MEMORY_ROOT>",
"COMPOUND_MEMORY_AGENT_ID": "<COMPOUND_MEMORY_AGENT_ID>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
COMPOUND_MEMORY_ROOTOptional | Store root directory. A leading ~ or $HOME/${HOME} is expanded; unset or blank falls back to $HOME/.agents/memory |
COMPOUND_MEMORY_AGENT_IDOptional | Stable 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 |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 29 Oct 2026 |
| Last updated | 29 Oct 2026 |
| Registry name | io.github.chinwe/compound-memory |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
