# HeapFile

> HeapFile is a freemium MCP server for agent tooling. Persistent work memory for AI coding clients, kept on your own computer. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS, Windows, API, Web
- **Website:** https://heapfile.ai
- **Repository:** https://github.com/heapfile-ai/heapfile-ai-integrations
- **MCP Registry name:** io.github.HeapFile-AI/heapfile-memory
- **Categories:** agent tooling
- **Listing updated:** 2026-11-18

## About

The README describes the public repository as a thin integration package: manifests, onboarding guidance and an OAuth reference to a hosted MCP endpoint, with the runtime itself not included. The website positions HeapFile as a local MCP server that runs beside clients such as Claude Code, Codex, Cursor and VS Code, so a new session can pick up findings, decisions and open tasks from earlier ones.

According to the site, the AI client calls a prepare_work tool before starting a task and a remember tool when it reaches a conclusion. Saved items keep a pointer to the file or commit they came from. Anything that leaves the computer or changes a system waits for the user's approval.

The free tier covers local memory, recall and repo evidence on one machine. Paid premium adds encrypted cross-device sync, connectors, team workspaces and savings reports. Memory stays local unless a cloud feature is turned on, and telemetry is off by default.

## Features

- **Local work memory:** Stores findings, decisions and open tasks on the user's computer so later sessions can reuse them.
- **Evidence-linked recall:** Saved items record the file or commit they were derived from, so recalled context can be checked.
- **Pre-task context loading:** The prepare_work tool gives the client prior findings before it begins work on a task.
- **Approval-gated actions:** Actions that leave the computer or change a system wait for explicit user approval.
- **Local value ledger:** The desktop app keeps a record of what happened on the user's own computer.

## Good for

- Resume a multi-day debugging task without re-explaining earlier findings
- Recall why a previous fix was reverted before changing the same code
- Keep open tasks and decisions across Claude Code, Cursor or VS Code sessions
- Carry context from a desktop session into a later handoff on another device

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http heapfile-memory https://mcp.heapfile.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.heapfile.ai/mcp
```

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

```json
{
  "mcpServers": {
    "heapfile-memory": {
      "url": "https://mcp.heapfile.ai/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "heapfile-memory": {
      "type": "http",
      "url": "https://mcp.heapfile.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heapfile-memory": {
      "serverUrl": "https://mcp.heapfile.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "heapfile-memory": {
      "type": "http",
      "url": "https://mcp.heapfile.ai/mcp"
    }
  }
}
```

## Tools

- `personal_brain_summary`: Read-only summary of stored work memory.
- `personal_brain_changes`: Read-only view of recent changes to stored memory.
- `personal_brain_remember`: Saves a concise item to memory; requires a separate write scope and per-save approval.

## FAQ

### Is there a free version?

The site says the free tier covers local memory and recall, prepare_work, local repo evidence and the local Value Ledger on one computer.

### Which AI clients does it work with?

The website names Claude Code, Codex, GitHub Copilot CLI, Gemini CLI, Cursor and VS Code as compatible clients.

### Does my data leave my computer?

The site says memory stays on the computer unless a cloud feature is turned on, and telemetry is off by default.

### Which tools does the hosted MCP connector expose?

The README lists personal_brain_summary, personal_brain_changes and personal_brain_remember. The first two are read-only, and remember requires a separate write scope.

### Is HeapFile free?

HeapFile has a free plan, with paid plans for more usage or features.

### How do I add HeapFile to Claude Code?

Run this command in your terminal: claude mcp add --transport http heapfile-memory https://mcp.heapfile.ai/mcp

### What are the best alternatives to HeapFile?

The closest alternatives to HeapFile are BotShelf Vampire, Agent interoperability design — Atom, Agent context packaging — Atom, Zero knowledge claim audit — Atom and Zero trust evaluation verdict — Atom.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BotShelf Vampire](https://ai-powered.com/mcp/botshelf-vampire): BotShelf Vampire is an open-source MCP server for agent tooling.
- [Agent interoperability design — Atom](https://ai-powered.com/mcp/agent-interoperability-design-atom): Agent interoperability design — Atom is an MCP server for design and media.
- [Agent context packaging — Atom](https://ai-powered.com/mcp/agent-context-packaging-atom): Agent context packaging — Atom is an MCP server for agent tooling.
- [Zero knowledge claim audit — Atom](https://ai-powered.com/mcp/zero-knowledge-claim-audit-atom): Zero knowledge claim audit — Atom is an MCP server for security.
- [Zero trust evaluation verdict — Atom](https://ai-powered.com/mcp/zero-trust-evaluation-verdict-atom): Zero trust evaluation verdict — Atom is an MCP server for ai models and llm tooling.
- [Network exposure audit — Atom](https://ai-powered.com/mcp/network-exposure-audit-atom): Network exposure audit — Atom is a paid MCP server for security.
- [BotMarket](https://ai-powered.com/mcp/botmarket): BotMarket is a free MCP server for agent tooling.
- [WritersLogic agent-infra](https://ai-powered.com/mcp/writerslogic-agent-infra): WritersLogic agent-infra is a paid MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/heapfile
