Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add offload-mcp-server -- npx -y offload-mcp-server
Open on GitHub

What 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-server

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

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open