Skip to content
MCP server

Free the Tools

Run everyday PDF, image, text and data tools on your own machine from an AI assistant

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.1.2
Listing updated
2 days ago

About Free the Tools

Free the Tools is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

The aim is to stop an assistant installing Ghostscript, ImageMagick or a Python package every time you ask it to shrink a PDF. This package gives it a ready set of tools that run locally: compressing, merging, splitting, rotating and unlocking PDFs, stripping location data from photos, converting CSV and JSON, hashing and case conversion. They match the ones on the freethetools.com website.

Privacy is the selling point. The server makes no network connection of its own, nothing is uploaded or counted, and results are saved in a library folder you can set with FREETHETOOLS_LIBRARY, by default a freethetools folder in your home directory. The job record keeps options such as quality or page range but never the text you supplied or a password. Because everything an assistant reads passes through your conversation, the README suggests the website rather than an assistant for secrets.

It runs through npx on Node.js 22 or later over stdio, and also offers a command line (freethetools list, freethetools run) and a code library. Claude Desktop needs absolute file paths.

Install

Run in a terminal

claude mcp add freethetools -- npx -y freethetools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "freethetools": {
      "command": "npx",
      "args": [
        "-y",
        "freethetools"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "freethetools": {
      "command": "npx",
      "args": [
        "-y",
        "freethetools"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "freethetools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "freethetools"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "freethetools": {
      "command": "npx",
      "args": [
        "-y",
        "freethetools"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "freethetools": {
      "command": "npx",
      "args": [
        "-y",
        "freethetools"
      ]
    }
  }
}

Configuration

  • FREETHETOOLS_LIBRARYFolder where results and the record of jobs are kept. Default: a folder named freethetools in your home folder.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

merge_pdfs
Combine PDF files into one
compress_pdf
Make a PDF smaller
convert_case
Change the case of text

What it does

Local PDF tools
Compress, merge, split, rotate and unlock PDFs without uploading them.
Photo privacy
Strip location data from images.
Data and text jobs
Convert CSV and JSON, hash content and change text case.
No network use
The server makes no connection of its own and nothing is counted.
CLI and library
Run tools from the command line or import them in JavaScript.
Job record
Options are logged, but never text, passwords or secrets.

Good for

  • Shrink a PDF to fit an email limit
  • Combine several PDFs into one
  • Remove GPS data from photos before sharing
  • Convert a CSV export to JSON
  • Hash a file to check its integrity

Pricing

Open source

Free, open source, no ads or sign-up

Prices change. Check freethetools.com before you buy.

Free the Tools FAQ

Do my files leave my computer?

No. The server runs locally and makes no network connection of its own.

Where are results stored?

In a library folder, by default a freethetools folder in your home folder, or the path in FREETHETOOLS_LIBRARY.

What do I need to run it?

Node.js 22 or later; npx fetches the package on first use.

Can I use it without MCP?

Yes, through the freethetools command line or as a library.

Is Free the Tools free?

Yes. Free the Tools is open source, so you can use and self-host it for free.

How do I add Free the Tools to Claude Code?

Run this command in your terminal: claude mcp add freethetools -- npx -y freethetools

What are the best alternatives to Free the Tools?

The closest alternatives to Free the Tools are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

Alternatives to Free the Tools

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents