HeapFile
Persistent work memory for AI coding clients, kept on your own computer
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.heapfile.ai/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"heapfile-memory": {
"url": "https://mcp.heapfile.ai/mcp"
}
}
}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.
Alternatives to HeapFile

BotShelf Vampire
MCP serverRead-only MCP server to search and read free items from the BotShelf Vampire shelf
Not checked yet- 3 tools
- Remote
- Open source
- Agent tooling
Agent interoperability design — Atom
MCP serverDeterministic API/MCP check that grades an agent-interoperability design manifest
Not checked yet- Remote
- Design and media
Agent context packaging — Atom
MCP serverDeterministic verdict on an agent context-pack manifest, per API call
Not checked yet- Remote
- Agent tooling
Zero knowledge claim audit — Atom
MCP serverPay-per-call MCP service that audits zero knowledge claims and returns a deterministic
Not checked yet- Remote
- Security
Zero trust evaluation verdict — Atom
MCP serverPer-call zero trust evaluation verdict for agents and developers, served over MCP and API
Not checked yet- Remote
- AI models and LLM tooling
Network exposure audit — Atom
MCP serverPay-per-call MCP service that audits declared network exposure evidence and returns
Not checked yet- Remote
- Paid
- Security