Skip to content
MCP server

HeapFile

Persistent work memory for AI coding clients, kept on your own computer

Install
Pricing
Freemium
Platforms
macOS, Windows, API
Runs
Remotely
Version
1.0.0
Listing updated
today

About HeapFile

HeapFile is a freemium MCP server for agent tooling. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.heapfile.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "heapfile-memory": {
      "url": "https://mcp.heapfile.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

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

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.

What it does

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

Pricing

Freemium

Free for local memory on one computer; premium adds cloud sync, connectors and team workspaces.

Prices change. Check heapfile.ai before you buy.

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

How AIPoweredBot checks servers

Alternatives to HeapFile

  1. Read-only MCP server to search and read free items from the BotShelf Vampire shelf

    Not checked yet
    • 3 tools
    • Remote
    • Open source
    • Agent tooling
  2. Deterministic verdict on an agent context-pack manifest, per API call

    Not checked yet
    • Remote
    • Agent tooling
  3. Pay-per-call MCP service that audits zero knowledge claims and returns a deterministic

    Not checked yet
    • Remote
    • Security
  4. Per-call zero trust evaluation verdict for agents and developers, served over MCP and API

    Not checked yet
    • Remote
    • AI models and LLM tooling
  5. Pay-per-call MCP service that audits declared network exposure evidence and returns

    Not checked yet
    • Remote
    • Paid
    • Security