offload — Claude Code MCP server: what it does, how to install
offload is an MCP server for Claude Code that delegates large code-reading tasks to a background CLI agent, returning a short report to the main assistant.
MIT ★ 23 updated 2026-11-10
claude mcp add offload-mcp-server -- npx -y offload-mcp-serverWhat offload does
offload-mcp-server equips your primary coding assistant with tools to hand off file reading, log scanning, and code tree inspection to a background worker agent. The background CLI processes large tasks on its own quota while your main agent retrieves concise summaries and targeted findings with line references. Running the setup utility automatically detects the CLI, registers the server, and configures local files.
Asynchronous execution lets you run multiple background jobs in parallel without blocking your workflow. A built-in dashboard tracks active jobs, opened files, and execution status in real time. Requirements include Node.js 20.3+ and a signed-in Antigravity CLI installation.
What it helps with
- offload heavy file reading to a background agent
- gather endpoint inventories without exhausting context
- inspect large code trees asynchronously
- monitor background worker jobs via a live dashboard
Example prompts for the agent
- Inventory every HTTP endpoint under api/ using offload and show me the summary.
- Analyze the log files in the background and return only key errors.
- Run a background scan of the project structure and provide a brief report.
How to install offload
Platform CLI
claude mcp add offload-mcp-server -- npx -y offload-mcp-serverPlatform CLI
codex mcp add offload -- npx -y offload-mcp-serverConfig file
{
"mcpServers": {
"offload": {
"command": "npx",
"args": [
"-y",
"offload-mcp-server"
]
}
}
}Config file
{
"servers": {
"offload": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"offload-mcp-server"
]
}
}
}Platform CLI
gemini mcp add offload npx -y offload-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about offload
How to install offload in Claude Code?
Run claude mcp add offload-mcp-server -- npx -y offload-mcp-server in your terminal.
What does offload do?
It saves your main AI agent context by delegating bulky code reading and file scanning to a background worker CLI.
What is needed to run offload?
You need Node.js 20.3 or higher along with an installed and signed-in Antigravity CLI.