Skip to content
MCP server

Homestead Memory

Tamper-evident local record of what your AI agent did, plus verifiable markdown memory

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.5.2
Listing updated
1 day ago

About Homestead Memory

Homestead Memory is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Homestead Memory starts from a familiar failure: an agent reports success, the tool returns 200 and the requested thing never happened, with no record to contradict it. A Claude Code hook records each tool call into a local hash-chained file, before the tool runs and after, so edits, deletions or reordering break every later hash and hsm watch reports the exact index and exits non-zero. Signing the chain also catches a fully rebuilt one. The README calls it tamper-evident, not tamper-proof, and says the recording adds about 124 ms per tool call.

It also manages memory as plain markdown you own. Checks score integrity from 0 to 100 and flag rot such as contradictions or vanished sources, tampering after signing with ed25519 and poisoning, where unsourced input must cite a real source or be dropped. hsm verify exits non-zero on problems so it can gate CI. The MCP server exposes nine tools: ask, search, verify, history, ingest, distill, sign, remember and resolve.

It needs Python 3.10 or newer, runs on macOS, Linux and Windows with no server, and exports an evidence pack a third party can verify with nothing installed. An optional export follows an IETF individual draft on agent audit trails, and the README warns that draft carries an IPR disclosure with a possible royalty and should not be the basis of a compliance programme. It is MIT licensed.

Install

Run in a terminal

claude mcp add homestead-memory -- uvx homestead-memory

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "homestead-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "homestead-memory"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "homestead-memory": {
      "command": "uvx",
      "args": [
        "homestead-memory"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "homestead-memory": {
      "command": "uvx",
      "args": [
        "homestead-memory"
      ]
    }
  }
}

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

ask
Asks the memory a question.
search
Searches the memory.
verify
Verifies the memory's integrity.
history
Reads history.
ingest
Ingests files into the vault.
distill
Extracts facts with verbatim quotes.
sign
Signs the vault.
remember
Stores a memory.
resolve
Resolves contradictions.

What it does

Hash-chained action log
Records decisions and outcomes of tool calls so changes to history are detectable.
Evidence pack
Export a bundle a third party can verify without installing anything.
Memory health scoring
Scores a markdown vault from 0 to 100 and flags rot, tampering and poisoning.
Signing
ed25519 signatures catch edits made after a fact was signed.
CI gate
hsm verify exits non-zero on failure like a test suite.
Local and plain files
No server or platform, with memory stored as markdown you can diff.

Good for

  • Prove what an agent did when it claims success
  • Gate a pipeline on the integrity of an agent's memory
  • Keep agent memory in files under version control
  • Hand an auditor a verifiable record of agent tool calls

Pricing

Open source

Free, MIT licensed

Prices change. Check fuckbigtech.ai before you buy.

Homestead Memory FAQ

Is the log tamper-proof?

No. The README says tamper-evident, not tamper-proof, and describes what it does and does not defend against.

What does it cost in speed?

About 124 ms per tool call at the median in the author's measurement.

What do I need to run it?

Python 3.10 or newer, or uvx to fetch a suitable Python.

What licence is it?

MIT.

Is Homestead Memory free?

Yes. Homestead Memory is open source, so you can use and self-host it for free.

How do I add Homestead Memory to Claude Code?

Run this command in your terminal: claude mcp add homestead-memory -- uvx homestead-memory

What are the best alternatives to Homestead Memory?

The closest alternatives to Homestead Memory are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Homestead Memory

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools