ConversionTools File Conversion

Convert files between 140+ formats directly from your agent using the ConversionTools MCP server.

Setup

If the ConversionTools MCP server is already connected, skip to Available Tools.

If the MCP server is not connected, add it:

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

Restart Claude Code after adding the server. MCP server changes require a restart to take effect.

On first use, you will be prompted to authenticate via OAuth in your browser. Free accounts get 100 conversions per month (10 per day). Paid plans available at conversiontools.io/pricing.

Available Tools

All tools use the conversiontools MCP server prefix: conversiontools:tool_name.

conversiontools:convert_file — Convert a file

The primary tool. Provide input and output paths — the converter is auto-detected from file extensions.

Parameters:

• input_path (required): Path to the input file
• output_path (required): Path for the converted output file
• file_content (optional): Base64-encoded file content for files up to 5MB
• file_id (optional): File ID from a previous conversiontools:request_upload_url call
• converter (optional): Explicit converter type like convert.pdf_to_excel. Auto-detected if omitted.
• options (optional): Converter-specific options

conversiontools:request_upload_url — Upload large files

Get a signed URL for uploading files larger than 5MB.

Parameters:

• filename (required): Name of the file to upload

Flow for large files:

1. Call conversiontools:request_upload_url with the filename
2. Upload file to the returned URL using PUT
3. Call conversiontools:convert_file with the returned file_id

conversiontools:list_converters — Browse available converters

Parameters:

• category (optional): documents, data, images, pdf, audio, video, ebook, ocr, ai, subtitles, web
• input_format (optional): Filter by input format, e.g. pdf
• output_format (optional): Filter by output format, e.g. csv

conversiontools:find_converter — Find the right converter

Parameters:

• input_format (required): e.g. pdf
• output_format (required): e.g. excel

conversiontools:get_converter_info — Get converter details

Parameters:

• converter (required): Converter type, e.g. convert.pdf_to_excel

conversiontools:auth_status — Check login status

conversiontools:auth_login — Trigger OAuth login

conversiontools:auth_logout — Clear credentials

How to Convert Files

You must provide the file content — the server cannot read local paths. Choose the method based on file size. The response includes a download_url — download the result with curl.

Small files (up to 5MB)

1. Base64-encode the file
2. Call conversiontools:convert_file with file_content, input_path, and output_path
3. Download the result from the returned download_url

# 1. Encode
base64_content=$(base64 -w 0 data.json)

# 2. Convert
conversiontools:convert_file({
  input_path: "data.json",
  output_path: "data.csv",
  file_content: "<base64_content>"
})

# 3. Download
curl -sL "<download_url>" -o data.csv

Large files (over 5MB)

1. Call conversiontools:request_upload_url with the filename to get a signed upload URL and file_id
2. Upload the file to the returned URL with curl -X PUT
3. Call conversiontools:convert_file with the file_id instead of file_content
4. Download the result from the returned download_url

Supported Conversions

Documents

• Word (docx, doc) → PDF, HTML, Text
• PowerPoint (pptx, ppt) → PDF
• Excel (xlsx, xls) → PDF, CSV, HTML, JSON, XML
• Markdown → PDF, HTML, EPUB

PDF

• PDF → Word, Excel, CSV, Text, HTML, JPG, PNG, EPUB
• JPG/PNG → PDF

Data Formats

• JSON ↔ CSV, Excel, XML, YAML
• CSV ↔ JSON, XML, Excel
• XML ↔ JSON, CSV, Excel
• YAML → JSON

Images

• PNG ↔ JPG, WebP, AVIF, SVG
• JPG ↔ PNG, WebP, AVIF
• WebP ↔ PNG, JPG
• AVIF ↔ PNG, JPG
• HEIC → JPG, PNG
• SVG → PNG, JPG
• Remove EXIF metadata

Audio

• WAV ↔ MP3
• FLAC → MP3, WAV

Video

• MOV, MKV, AVI → MP4
• MP4 → MP3 (extract audio)

E-books

• EPUB ↔ MOBI
• EPUB, MOBI → PDF
• Markdown → EPUB

OCR (Text Recognition)

• PNG, JPG → Text (OCR)
• Scanned PDF → Text (OCR)
• PNG, JPG → Searchable PDF (OCR)

AI-Powered

• PDF → JSON, CSV, Excel, Markdown (AI extraction)
• Images → JSON (AI extraction)
• Subtitles → Translated subtitles (AI)

Subtitles

• SRT ↔ VTT
• SRT → CSV, Text

Web

• Website URL → PDF, JPG, PNG (screenshot)
• HTML → JPG, PNG
• HTML tables → CSV

Tips

• Auto-detection works well — just provide file paths with correct extensions and skip the converter parameter
• Use conversiontools:list_converters with filters when unsure what’s available: conversiontools:list_converters({ input_format: "pdf" }) shows all PDF output options
• AI converters (convert.ai_pdf_to_json, etc.) use AI to intelligently extract structured data from complex documents — use these when standard converters produce poor results
• OCR converters are for scanned documents and images containing text — use when the source is an image or non-searchable PDF
• For batch conversions, upload a ZIP, 7z, XZ, or RAR archive containing all files — they will all be converted and returned as a .result.zip file. Alternatively, call conversiontools:convert_file once per file.