# abox.tools

> abox.tools is an MCP server for files and documents. Local MCP server for offline image, PDF, QR and file tools, plus opt-in live sessions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** Windows, macOS, Linux, CLI
- **Repository:** https://github.com/a-box-of-tools/abox-tools-plugin
- **MCP Registry name:** io.github.A-Box-of-Tools/abox-tools
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

This adapter wraps the existing abox.tools code so an agent can process local files without sending bytes through tool responses. An agent passes file paths and gets output paths and short JSON back. The v0.11.0 release lists 66 offline file operations and six live-session controls, which with a capabilities tool makes 72 operations and 73 MCP tools.

Operations include compressing, resizing and converting images, merging, splitting, watermarking, protecting and unlocking PDFs, extracting PDF tables to CSV, QR and barcode generation, receipt field extraction with bundled OCR, JSON, XML and YAML conversion, metadata removal and checksums. Some image, GIF, OCR and video routes need an installed Edge, Chrome or Chromium; QR codes default to SVG without a browser.

Live mode is separate and opt-in. A visible companion window starts nothing until the person clicks Start. It uses direct encrypted WebRTC with no relay or recording, though the pairing service keeps seven-day Cloudflare metadata logs. Release bundles ship their own Node runtime for Windows, macOS and Linux, with Codex, Claude Desktop, Gemini CLI and Cursor installs described.

## Features

- **Offline file processing:** Images, PDFs, text and media are handled on your computer.
- **PDF toolkit:** Compress, merge, split, rotate, watermark, protect, unlock and redact pages.
- **Images and codes:** Convert images, build ICO files and generate QR codes and barcodes.
- **Receipt OCR:** Bundled OCR extracts fields from receipts.
- **Opt-in live sessions:** Text, camera and voice run in a companion window the person starts.
- **Bundled runtime:** Releases include Node.js, so no npm setup is needed.

## Good for

- Compress and convert a folder of images
- Merge and watermark PDFs from a chat
- Extract a table from a PDF into CSV
- Remove metadata from photos before sharing
- Generate a QR code to a local file

## Install

### Claude Code (Terminal)

```sh
claude mcp add abox-tools -- npx -y https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "abox-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "abox-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "abox-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "abox-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "abox-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb"
      ]
    }
  }
}
```

## FAQ

### Do my files leave my computer?

The README says offline processing keeps bytes on your computer and out of tool responses.

### Which platforms are covered?

Windows x64, macOS on Apple silicon and Intel, and Linux x64.

### Does live mode record anything?

No. It uses direct encrypted WebRTC with no relay, discovery or recording.

### Do I need a browser installed?

Some image, OCR and video routes need Edge, Chrome or Chromium; PDF and text operations do not.

### How do I add abox.tools to Claude Code?

Run this command in your terminal: claude mcp add abox-tools -- npx -y https://github.com/A-Box-of-Tools/abox-tools-plugin/releases/download/v0.11.0/abox-tools-0.11.0-universal.mcpb

### What are the best alternatives to abox.tools?

The closest alternatives to abox.tools are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/abox-tools
