# Heartwood Memory — governed memory for AI agents

> Heartwood Memory — governed memory for AI agents is a freemium MCP server for knowledge and memory. Governed local memory for coding agents with signed provenance and policy-gated recall. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $349 a month
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Website:** https://heartwoodmemory.com
- **Repository:** https://github.com/jermayne36/heartwood-memory
- **MCP Registry name:** io.github.jermayne36/heartwood-memory
- **Categories:** knowledge and memory, security
- **Listing updated:** 2026-11-16

## About

Heartwood targets forgetting between sessions and projects rather than inside one context window. Every memory is signed and the signature is re-checked at each recall. Before ranking, recall removes records the caller is not cleared to use, and each result carries its author, source IDs and signature status. Writes and deletions go into a hash-chained audit log, and erasing a subject destroys that subject's key and can issue a signed receipt verifiable offline.

It runs as an embedded Python library or a local stdio MCP server over one SQLite file shared by clients such as Claude Code, Codex and a read-only Copilot plugin. By default the tool allowlist is read-only: recall, explain_recall and health, while remember and forget must be named explicitly. If no database path is set, memory lives in RAM and is lost when the server stops.

The core is source-available under BSL 1.1, not OSI open source. Community use is free for non-production and for organizations under 100 people and $1 million in revenue; Team is $349 a month and Professional $6,000 a year, offered to US organizations.

## Features

- **Signed memories:** Signs each memory and rechecks the signature on every recall.
- **Policy-gated recall:** Removes records the caller is not cleared for before ranking.
- **Crypto-shred erasure:** Destroys a subject's key and can issue a signed receipt.
- **Hash-chained audit log:** Records writes and deletions tamper-evidently.
- **Read-only by default:** Exposes recall, explain_recall and health unless you add more.
- **Shared local store:** One SQLite file readable by several MCP clients.
- **Opt-in hosted judge:** Hosted plans can use an optional model to rank recall.

## Good for

- Give coding agents memory that carries across sessions and projects
- Show where an agent's answer came from
- Erase one person's data and keep proof of it
- Share one memory store between Claude Code and Codex
- Audit what an agent remembered and recalled

## Install

### Claude Code (Terminal)

```sh
claude mcp add heartwood-memory --env HEARTWOOD_DB_PATH='<HEARTWOOD_DB_PATH>' -- uvx heartwood-memory
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "heartwood-memory": {
      "command": "uvx",
      "args": [
        "heartwood-memory"
      ],
      "env": {
        "HEARTWOOD_DB_PATH": "<HEARTWOOD_DB_PATH>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heartwood-memory": {
      "command": "uvx",
      "args": [
        "heartwood-memory"
      ],
      "env": {
        "HEARTWOOD_DB_PATH": "<HEARTWOOD_DB_PATH>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "heartwood-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "heartwood-memory"
      ],
      "env": {
        "HEARTWOOD_DB_PATH": "<HEARTWOOD_DB_PATH>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heartwood-memory": {
      "command": "uvx",
      "args": [
        "heartwood-memory"
      ],
      "env": {
        "HEARTWOOD_DB_PATH": "<HEARTWOOD_DB_PATH>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heartwood-memory": {
      "command": "uvx",
      "args": [
        "heartwood-memory"
      ],
      "env": {
        "HEARTWOOD_DB_PATH": "<HEARTWOOD_DB_PATH>"
      }
    }
  }
}
```

## Tools

- `recall`: Recalls memories the caller is cleared to use.
- `explain_recall`: Explains why a recall result was returned.
- `health`: Reports server health.
- `remember`: Stores a memory; must be added to the allowlist.
- `forget`: Erases memories; must be added to the allowlist.

## FAQ

### Is it open source?

No. The core is source-available under BSL 1.1, and each release becomes Apache-2.0 four years after shipping.

### What does it cost?

Community is free for non-production and for qualifying small organizations; Team is $349/month and Professional is $6,000/year.

### Does it keep memory after a restart?

Only if you set an absolute database path; otherwise memory stays in RAM.

### Is hosted MCP available?

No. MCP runs over local stdio on one machine.

### Is Heartwood Memory — governed memory for AI agents free?

Heartwood Memory — governed memory for AI agents has a free plan, with paid plans for more usage or features. Paid plans start at $349 a month.

### How do I add Heartwood Memory — governed memory for AI agents to Claude Code?

Run this command in your terminal: claude mcp add heartwood-memory --env HEARTWOOD_DB_PATH='<HEARTWOOD_DB_PATH>' -- uvx heartwood-memory

### What are the best alternatives to Heartwood Memory — governed memory for AI agents?

The closest alternatives to Heartwood Memory — governed memory for AI agents 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/heartwood-memory-governed-memory-for-ai-agents
