# heropen — AI Agent Memory

> heropen — AI Agent Memory is a free MCP server for knowledge and memory. Local-first long-term memory for AI agents, stored on your own machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Windows, macOS, Linux, self-hosted
- **Website:** https://heropen.net
- **Repository:** https://github.com/koradji77/heropen
- **MCP Registry name:** net.heropen/heropen
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

heropen keeps an agent's memories in SQLite files under `~/.heropen/`, one file per agent, with nothing uploaded and no telemetry. It installs with `pip install heropen`, needs Python 3.10 or later, and asks for no Docker, Postgres or API key. On first launch it tries to register itself with known clients such as Claude Code, Cursor and Windsurf, while setups like Hermes need the `heropen-mcp` command wired in by hand.

Search is full-text out of the box, and local semantic search is an optional extra that downloads an embedding model of roughly 95 MB. If embeddings are unavailable, search falls back to full-text and storage keeps working. Other features the site lists include a browser dashboard for viewing and managing memories, session checkpoint protection when a conversation is compressed, a time-awareness note at the start of each chat, and a Windows tray badge. The free tier gives eight fully private agents plus an optional shared domain where agents exchange knowledge.

The free version has no time limit. Plus and enterprise tiers are described as coming, with shared memory domains, private deployment and permissions. The website is written in Chinese, and a JSON export is available through `heropen export`.

## Features

- **Local storage:** One SQLite file per agent under your home directory, never uploaded.
- **Full-text and semantic search:** Full-text by default, local embeddings as an optional extra.
- **Private and shared domains:** Eight private agents on the free tier plus an optional shared domain.
- **Session checkpoints:** Context survives when a conversation is compressed.
- **Time awareness:** Each session opens with local time and the gap since the last chat.
- **Browser dashboard:** View, search and manage memories and agents from a local panel.

## Good for

- Give a coding agent memory of project conventions across sessions
- Keep personal preferences available in every chat
- Share notes between two agents through a shared domain
- Back up memories as JSON and move them to another machine

## Install

### Claude Code (Terminal)

```sh
claude mcp add heropen -- uvx heropen
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "heropen": {
      "command": "uvx",
      "args": [
        "heropen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heropen": {
      "command": "uvx",
      "args": [
        "heropen"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "heropen": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "heropen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heropen": {
      "command": "uvx",
      "args": [
        "heropen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heropen": {
      "command": "uvx",
      "args": [
        "heropen"
      ]
    }
  }
}
```

## FAQ

### Does any data leave my machine?

The README says memories are never uploaded or synced, with no telemetry or cloud sync.

### Do I need an API key?

No. Installation is a single pip command with no key, Docker or database.

### Does it work without embeddings?

Yes. Search falls back to full-text and storage and retrieval keep working.

### What is free?

The free version has no time limit and includes basic memory, the MCP server, local storage and the dashboard.

### Is heropen — AI Agent Memory free?

Yes. heropen — AI Agent Memory is free to use.

### How do I add heropen — AI Agent Memory to Claude Code?

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

### What are the best alternatives to heropen — AI Agent Memory?

The closest alternatives to heropen — AI Agent Memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/heropen-ai-agent-memory
