Headroom MCP Server

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Canonical URL

https://heyclau.de/entry/mcp/headroom-mcp-server

Source URLs

https://headroom-docs.vercel.app/docs/mcp, https://github.com/headroomlabs-ai/headroom

Brand

Headroom

Brand domain

headroom-docs.vercel.app

Brand asset source

brandfetch

Safety notes

Compression can omit details from the active model context; use retrieval tools when exact logs, code, or evidence matter., Do not treat compressed summaries as authoritative for security, legal, financial, or incident-response decisions without checking originals., Local memory and reversible compression stores should be protected, purged, or excluded from backups when they contain sensitive data., Evaluate compression behavior on your own task types before relying on it for critical workflows.

Privacy notes

Tool outputs, logs, source files, prompts, RAG chunks, and conversation context may be stored locally for compression and retrieval., Local stores can include secrets, customer data, stack traces, repository paths, and proprietary code unless filtered upstream., If using proxy or provider integrations beyond local MCP tools, review which data is forwarded to external model providers.

Author

Tejas Chopra

Submitted by

oktofeesh1

Claim status

unclaimed

Last verified

2026-06-05

• Tool outputs, logs, source files, prompts, RAG chunks, and conversation context may be stored locally for compression and retrieval.
• Local stores can include secrets, customer data, stack traces, repository paths, and proprietary code unless filtered upstream.
• If using proxy or provider integrations beyond local MCP tools, review which data is forwarded to external model providers.

• Python 3.10 or newer.
• Headroom package installed with MCP support.
• Local disk space for reversible compression, memory, and retrieval stores.
• MCP client such as Claude Code, Codex, Cursor, Aider, or another compatible host.
• Team agreement on what content can be compressed, stored, and retrieved by an agent.

Show that Headroom MCP Server is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

[![Listed on HeyClaude](https://heyclau.de/badge/mcp/headroom-mcp-server.svg)](https://heyclau.de/entry/mcp/headroom-mcp-server)

Headroom MCP Server side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

Field	Headroom MCP Server Local-first context compression MCP server for reducing tool outputs, logs, files, RAG chunks, and agent context before they reach the model. Open dossier	LeanCTX MCP Server Local-first context-engineering MCP server and CLI that gives Claude token-efficient file reads, shell-output compression, code search, graph queries, persistent session memory, context packaging, verification tools, and dashboard-style token accounting through a single Rust binary. Open dossier	ButlerBrain MCP Server for Claude ButlerBrain hosted MCP server providing persistent memory for AI assistants so Claude can store and recall context across sessions via api.butlerbrain.ai. Open dossier	Context Mode MCP Server MCP server for context-window optimization that routes large tool outputs through sandbox tools, indexes session state, and helps agents retrieve only the context they need. Open dossier
Next steps	Open dossierCopy installCopy configAPI JSONOpen LLMMCP feedOpen sourceNewsletterClaim listing	Open dossierCopy installCopy configAPI JSONOpen LLMMCP feedOpen sourceNewsletterClaim listing	Open dossierCopy installCopy configAPI JSONOpen LLMMCP feedOpen sourceNewsletterClaim listing	Open dossierCopy installCopy configAPI JSONOpen LLMMCP feedOpen sourceNewsletterClaim listing
Trust	Review first	Review first	Review first	Review first
Review status	Not reviewed	Not reviewed	Not reviewed	Not reviewed
Package trust	Package not verified	Package not verified	Package not verified	Package not verified
Source provenanceDiffers	Source-backed	Source-backed	Submission linkedSource submission	Source-backed
SubmitterDiffers	oktofeesh1	oktofeesh1	kiannidev	oktofeesh1
Install risk	Review first	Review first	Review first	Review first
Notes	Safety ✓ Privacy ✓	Safety ✓ Privacy ✓	Safety ✓ Privacy ✓	Safety ✓ Privacy ✓
Brand	Headroom	LeanCTX	—	Context Mode
Category	mcp	mcp	mcp	mcp
Source	Source-backed	Source-backed	Source-backed	Source-backed
Author	Tejas Chopra	Yves Gude	ButlerBrain	mksglu
Added	2026-06-05	2026-06-06	2026-06-14	2026-06-05
Platforms	Claude CodeCodexCursorClaude Desktop	Claude CodeClaude Desktop	Claude CodeClaude Desktop	Claude CodeClaude Desktop
Harness	Claude CodeCodexCursorClaude Desktop	Claude CodeClaude Desktop	Claude CodeClaude Desktop	Claude CodeClaude Desktop
Source repo	—	—	—	—
Safety notes	✓Compression can omit details from the active model context; use retrieval tools when exact logs, code, or evidence matter. Do not treat compressed summaries as authoritative for security, legal, financial, or incident-response decisions without checking originals. Local memory and reversible compression stores should be protected, purged, or excluded from backups when they contain sensitive data. Evaluate compression behavior on your own task types before relying on it for critical workflows.	✓LeanCTX can read local files, run shell commands invoked through its tools, cache outputs, install shell/editor hooks, and persist session state. Review generated MCP and shell-hook changes before enabling them across all agents or shells. Keep path jail enforcement enabled for normal use, and allow extra roots only when a project genuinely needs them. Disable or restrict command-execution and unsafe I/O tools for regulated repositories, untrusted workspaces, or shared team environments. Treat compressed shell output and cached reads as summaries; switch to full reads or raw command output when exact source text matters.	✓Persistent memory can retain incorrect or outdated facts until explicitly updated or deleted. Memory write tools may store sensitive information if prompts include secrets or credentials. Shared ButlerBrain workspaces can expose memories to other authorised users in the same account. Review memory contents periodically to prevent unbounded accumulation of stale context.	✓Context Mode encourages agents to execute scripts and route large outputs through sandbox tools; review allowed commands and workspace boundaries. Hook-based installs can affect tool routing automatically. Verify the installed hooks and settings before using it in shared or sensitive workspaces. Indexed session state can influence future retrieval and continuity; purge state when switching projects, clients, or sensitivity levels. Do not rely on compressed or searched summaries for high-stakes decisions without inspecting original files or outputs.
Privacy notes	✓Tool outputs, logs, source files, prompts, RAG chunks, and conversation context may be stored locally for compression and retrieval. Local stores can include secrets, customer data, stack traces, repository paths, and proprietary code unless filtered upstream. If using proxy or provider integrations beyond local MCP tools, review which data is forwarded to external model providers.	✓Local code, file paths, command output, search terms, session notes, context packages, knowledge graph data, token metrics, and dashboard statistics can be sent to the MCP client and model. LeanCTX stores local stats and session state under its own configuration/data directories; protect these files if they contain project decisions, findings, or sensitive paths. Secret-like paths are blocked or role-gated by default according to upstream security docs, but users should still avoid prompting agents to read credentials, private keys, tokens, or ignored files. The upstream security policy describes optional update checks and opt-in anonymous stats sharing; disable network checks when working in confidential or offline environments.	✓Memories you save are stored on ButlerBrain infrastructure under its privacy and retention terms. Do not store passwords, API keys, health records, or other regulated data in assistant memory. Exported memory dumps may contain personal preferences; treat them as confidential user data.	✓Context Mode can index file edits, git operations, tasks, errors, user decisions, local files, and command output in SQLite/FTS5 stores. Indexed data may include source code, logs, secrets accidentally printed to terminal, customer data, repository paths, and private prompts. Local analytics and statusline data can reveal workflow patterns, tool usage, and project activity.
Prerequisites	Python 3.10 or newer. Headroom package installed with MCP support. Local disk space for reversible compression, memory, and retrieval stores. MCP client such as Claude Code, Codex, Cursor, Aider, or another compatible host.	npm for the `lean-ctx-bin` package, or another upstream-supported install path such as release binaries, Homebrew, Cargo, or AUR. A local repository workspace where LeanCTX is allowed to read files, run configured shell commands, and store session metadata. Review of generated MCP client config, shell hooks, per-project `.lean-ctx.toml`, and global `~/.config/lean-ctx/config.toml`. Explicit allow-listing for any paths outside the current project root that LeanCTX should be permitted to access.	ButlerBrain account with memory storage enabled for your workspace. Claude Pro, Team, or Enterprise with Connectors support, or Claude Code with HTTP MCP transport. Data retention policy review before storing customer PII or regulated data in persistent memory. Understanding of what should and should not be remembered across sessions.	Node.js 22.5 or newer, or Bun for supported installs. MCP client such as Claude Code, Gemini CLI, VS Code Copilot, Cursor, Codex, or another supported host. Optional Claude Code plugin marketplace support for automatic hooks and slash commands. Team agreement on what files, command outputs, and session events may be indexed locally.
Install	pip install "headroom-ai[mcp]" && headroom mcp install Copy install	npm install -g lean-ctx-bin Copy install	claude mcp add --transport http butlerbrain https://api.butlerbrain.ai/mcp Copy install	claude mcp add context-mode -- npx -y context-mode Copy install
Config	{ "mcpServers": { "headroom": { "command": "headroom", "args": ["mcp", "serve"] } } } Copy config	{ "mcpServers": { "lean-ctx": { "command": "lean-ctx", "env": { "LEAN_CTX_IO_BOUNDARY_MODE": "enforce", "LEAN_CTX_NO_UPDATE_CHECK": "1" } } } } Copy config	{ "mcpServers": { "butlerbrain": { "url": "https://api.butlerbrain.ai/mcp", "type": "http" } } } Copy config	{ "mcpServers": { "context-mode": { "command": "npx", "args": ["-y", "context-mode"] } } } Copy config
Citations	Source repositorygithub.com 2026-07-21T01:31:08+00:00 Documentationheadroom-docs.vercel.app Submitted by oktofeesh12026-06-05 Source methodology →	Source repositorygithub.com 2026-07-21T01:31:08+00:00 Documentationleanctx.com Submitted by oktofeesh12026-06-06 Source methodology →	Source repositorybutlerbrain.ai 2026-07-21T01:31:08+00:00 Documentationbutlerbrain.ai Submitted by kiannidev2026-06-14 Source methodology →	Source repositorygithub.com 2026-07-21T01:31:08+00:00 Documentationcontext-mode.com Submitted by oktofeesh12026-06-05 Source methodology →
Claim	Unclaimed	Unclaimed	Unclaimed	Unclaimed

Source-backed guides for putting this to work.