# Homestead Memory

> Homestead Memory is an open-source MCP server for knowledge and memory. Tamper-evident local record of what your AI agent did, plus verifiable markdown memory. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://fuckbigtech.ai/lab/
- **Repository:** https://github.com/fuckbigtech-ai/homestead-memory
- **MCP Registry name:** io.github.fuckbigtech-ai/homestead-memory
- **Categories:** knowledge and memory, security
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add homestead-memory -- uvx homestead-memory
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/homestead-memory
