HeapFile

● Active

io.github.HeapFile-AI/heapfile-memory

Remote MCP service for evidence-backed work memory and continuity.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "heapfile-memory": {
      "url": "https://mcp.heapfile.ai/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http heapfile-memory https://mcp.heapfile.ai/mcp
VS Code
code --add-mcp '{"name":"heapfile-memory","type":"http","url":"https://mcp.heapfile.ai/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Other
Version
1.0.0
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: HeapFile is maintained, open source, hosted endpoint behind a sign-in.

Maintained
Active
Last commit 4 days ago (Nov 18, 2026), 0 open issues.
Official registry
Active
Published as io.github.HeapFile-AI/heapfile-memory in the official MCP registry, version 1.0.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to mcp.heapfile.ai: prompts and tool arguments leave your machine for that host.
Credentials
Sign-in required
The hosted endpoint answered 401/403 to a credential-free call (checked Nov 22, 2026): it wants an API key or an OAuth login first.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 00:07 UTCStatus history & uptime →
● Needs sign-in

The endpoint is up but wants a key or an OAuth sign-in before the handshake, so its tools can only be read with an account.

Checked by Serverdex with a plain initialize + tools/list call to mcp.heapfile.ai/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 18, 2026
License
MIT

cursor-plugingemini-cli-extensionheapfilemcp

From the README

HeapFile AI integrations This is the public, provider-thin integration package for HeapFile. It contains only manifests, onboarding guidance, the approved brand asset, and an OAuth reference to HeapFile's hosted MCP service. It contains no HeapFile runtime, Brain implementation, storage code, private prompts, credentials, client secret, executable, or lifecycle hook. Supported discovery paths • Cursor Marketplace: .cursor-plugin/plugin.json and mcp.json are at the required repository-relative locations. Cursor signs the user in with PKCE and the public client identifier in mcp.json. • Gemini CLI gallery: gemini-extension.json is at the repository root. Gallery discovery additionally requires the gemini-cli-extension GitHub topic and a matching release tag. • Official MCP Registry: server.json describes the same remote Streamable HTTP server. Publishing requires namespace ownership authentication and is separate from building this repository. • GitHub Copilot: Copilot CLI can configure a remote HTTP server directly when that surface supports the server's authentication flow. Public GitHub MCP Registry discovery is a separate curated onboarding step after the official MCP Registry entry is active. The hosted connector exposes personalbrainsummary, personalbrainchanges, and personalbrainremember. The first two are read-only.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://mcp.heapfile.ai/mcp

The most-starred Other servers in the index, with their live-check result.

ServerStarsLast pushLive check
Labelhead Artist Momentum114,594Nov 2026Working
World Monitor91,002Nov 2026Needs sign-in
Tldraw51,470Nov 2026Working
OpenSEO28,515Nov 2026Needs sign-in
Windows MCP11,833Nov 2026Local / not checked

HeapFile: questions people ask

Is HeapFile a remote or a local MCP server?
According to its entry in the official MCP registry, HeapFile ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does HeapFile need an API key or a sign-in?
Yes. Its hosted endpoint answered the credential-free Serverdex live check with HTTP 401/403 on Nov 22, 2026: it expects an API key in a header or an OAuth login before it lists its tools.
Is HeapFile safe to use?
Looks healthy: HeapFile is maintained, open source, hosted endpoint behind a sign-in. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: Sign-in required. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is HeapFile still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add HeapFile to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Other →

Add the badge to your site

Show visitors that HeapFile is listed here — it’s also the link we check for a free listing.

HeapFile — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-heapfile-ai-heapfile-memory?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="HeapFile — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![HeapFile — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-heapfile-ai-heapfile-memory?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-heapfile-ai-heapfile-memory) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-heapfile-ai-heapfile-memory) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-heapfile-ai-heapfile-memory)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-heapfile-ai-heapfile-memory"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-heapfile-ai-heapfile-memory"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-heapfile-ai-heapfile-memory"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).