# FitFileSize

> FitFileSize is a free MCP server for files and documents. Compress PDFs and images, HEIC included, to fit an upload limit or a form's rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://fitfilesize.com/claude.html
- **Repository:** https://github.com/gautamstar/fitfilesize/tree/HEAD/mcp
- **MCP Registry name:** io.github.Gautamstar/fitfilesize
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

FitFileSize runs locally as an MCP server but sends each file over HTTPS to the FitFileSize service, where it is compressed and then deleted once the result is saved to your computer. Results are saved beside the original as name.fit.ext, so the source file is untouched. Files can be up to 50 MB, and a batch tool call takes up to 10 files that share one limit.

You can give a limit such as 200KB or choose a form preset that fixes the size range and exact pixel size. Presets include the US visa photo for the DS-160, the Indian e-Visa, IBPS, SBI, RRB, SSC, NEET, JEE Main, CUET and GATE uploads, IRCC documents and Discord emoji and banners. Formats stay the same (a PNG stays a PNG) unless you allow JPEG, and iPhone HEIC comes back as JPEG. A minimum size pads a small JPEG up without changing the picture.

It is free with no account or key, limited to 30 uploads an hour, and the server code is MIT-licensed. It needs Node.js 20.10 or newer and does not work in Claude on the web or phone apps.

## Features

- **Any size limit:** Fit a file under a limit such as 300 KB.
- **Form presets:** Presets set size range and pixel dimensions for named forms.
- **Batch fitting:** Up to ten files with one shared limit per call.
- **Format-preserving:** Keeps the file type unless JPEG is allowed.
- **HEIC support:** iPhone photos come back as JPEG.
- **Non-destructive output:** Saves a .fit copy beside the original.

## Good for

- Shrink a passport scan to a portal's limit
- Resize a photo to an exact visa photo spec
- Compress several certificates to 2 MB each
- Convert an iPhone HEIC photo for upload

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `fit_file`: Compress a file or up to ten files to a size limit or form preset.
- `list_forms`: List form presets with their rules and official sources.

## FAQ

### Is it free?

Yes, with no account or API key, within 30 uploads an hour.

### Does my file leave my computer?

Yes. It is sent over HTTPS to FitFileSize and deleted once the result is saved.

### What do I need?

Node.js 20.10 or newer and an MCP client such as Claude Desktop or Claude Code.

### Which forms have presets?

Examples include DS-160, IBPS, SBI, NEET, JEE Main, IRCC and Discord emoji; list_forms shows them all.

### Is FitFileSize free?

Yes. FitFileSize is free to use.

### How do I add FitFileSize to Claude Code?

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

### What are the best alternatives to FitFileSize?

The closest alternatives to FitFileSize are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/fitfilesize
