explaingit

medoxisto/toolbox-mcp

Analysis updated 2026-05-18

19TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

An MCP server that gives AI agents 35 local utility tools for things like OCR, exact math, PDF editing, image conversion, and crypto -- all running offline on your own machine.

Mindmap

mindmap
  root((toolbox-mcp))
    What it does
      35 local utility tools
      No network calls
      Runs via stdio MCP
    Tool categories
      OCR and media
      PDF operations
      Image processing
      Exact math and regex
      Crypto and hashing
      Text and data
    Works with
      Claude Desktop
      Cursor
      VS Code Copilot
      Google Antigravity
    Setup
      One JSON config snippet
      npx no install needed
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let Claude read exact text from a screenshot or scan using offline OCR rather than relying on vision model guessing.

USE CASE 2

Ask an AI agent to extract audio from a video file, trim a clip, or convert between formats without leaving the chat.

USE CASE 3

Have an AI assistant run an exact math expression, convert a time zone, or apply a regex and get a reliable, deterministic answer.

What is it built with?

TypeScriptNode.jsMCPffmpeg

How does it compare?

medoxisto/toolbox-mcpavacocloud/avaco-denodoorman11991/budget-aware-mcp
Stars191919
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node.js and adding one JSON snippet to your MCP client config file.

MIT license: use, modify, and distribute freely for any purpose including commercial use.

In plain English

toolbox-mcp is an MCP server that adds 35 practical utility tools to AI agents like Claude, Cursor, and VS Code Copilot. It runs entirely on your own machine over standard input and output, with no network calls and no data sent anywhere. The tools fill in the categories where language models tend to struggle or cannot help at all. There are tools for reading exact text from images using optical character recognition, processing audio and video files, reading and editing PDFs, working with images and Excel spreadsheets, running exact math calculations, converting between time zones, applying regular expressions precisely, and handling encoding, hashing, and cryptographic tasks. The author notes that while AI models are good at reasoning and writing code, they cannot open audio or video files, and they can make subtle errors on arithmetic and regex tasks where the correct answer must be exactly right. The tools are organized into groups: reading images and media (OCR, frame extraction, video conversion), PDF operations (extract text, merge, split, rotate, watermark), file and office tasks (Excel to JSON, zip, HTML to Markdown, EXIF metadata), image processing (convert, resize, crop, compress, watermark), compute tasks (calculator, timezone converter, regex extractor, diff, QR codes), cryptographic tools (hash functions, HMAC, bcrypt, UUID, JWT decode), and text and data utilities (JSON formatting, CSV to JSON, Base64, URL encoding, slug generation, case conversion, word count). To add it to Claude Desktop or Cursor, you paste a short JSON snippet into your MCP config file. The snippet uses npx to download and run the server with no installation or build step. VS Code and Google Antigravity use the same approach with a slightly different config file location. Once configured, restarting the client is enough to make all 35 tools available. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
I have toolbox-mcp connected to Claude. I have a PDF invoice at /Users/me/invoice.pdf. Extract the text and summarize the line items.
Prompt 2
Using toolbox-mcp, convert all JPEG images in a folder to WebP format and resize them to a max width of 1200px.
Prompt 3
I need to decode a JWT token and check the expiry timestamp. Use the jwt_decode tool and explain what each field means.
Prompt 4
Using the calculate tool in toolbox-mcp, convert 95 degrees Fahrenheit to Celsius and confirm the result is exactly right.

Frequently asked questions

What is toolbox-mcp?

An MCP server that gives AI agents 35 local utility tools for things like OCR, exact math, PDF editing, image conversion, and crypto -- all running offline on your own machine.

What language is toolbox-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does toolbox-mcp use?

MIT license: use, modify, and distribute freely for any purpose including commercial use.

How hard is toolbox-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is toolbox-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub medoxisto on gitmyhub

Verify against the repo before relying on details.