# Free the Tools

> Free the Tools is an open-source MCP server for files and documents. Run everyday PDF, image, text and data tools on your own machine from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://freethetools.com
- **Repository:** https://github.com/sapience-design/freethetools/tree/HEAD/packages/freethetools
- **MCP Registry name:** io.github.sapience-design/freethetools
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add freethetools -- npx -y freethetools
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/free-the-tools
