Skip to content
MCP server

FitFileSize

Compress PDFs and images, HEIC included, to fit an upload limit or a form's rules

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.2.1
Listing updated
2 days ago

About FitFileSize

FitFileSize is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add fitfilesize -- npx -y fitfilesize-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (2)

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

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.

What it does

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

Pricing

Free

Free; 30 uploads per hour

Prices change. Check fitfilesize.com before you buy.

FitFileSize 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 to FitFileSize

  1. ASTra

    MCP server

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

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. 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
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media