RookieKiwi/converteverything-mcp

ConvertEverything MCP Server

An MCP (Model Context Protocol) server that enables AI assistants like Claude to convert files between 100+ formats using the ConvertEverything.io API.

"Hey Claude, convert this HEIC to JPG" — it's that simple.

Why ConvertEverything?

Tired of sketchy converter websites with popup ads and "premium" upsells? We built ConvertEverything.io for developers and power users who want:

• No ads, no BS — Clean interface, fast conversions
• Actually free tier — 20 conversions/day with free account, no credit card required
• Serious file size limits — Up to 10GB per file (try finding that elsewhere)
• Privacy-first — Files auto-delete, no data mining
• API access — Because you're reading an MCP README, you probably want this

Features

• 100+ Supported Formats: Audio, video, image (including RAW camera formats), document, ebook, data, 3D, font, archive, and CAD files
• File Compression: Compress images, videos, and PDFs with quality presets
• Archive Creation: Create ZIP, TAR, 7z archives from multiple files
• File Sharing: Generate shareable links and send files via email
• Cloud Import: Import files from Google Drive, Dropbox, OneDrive, and Box
• Simple Integration: Works with Claude Desktop, Claude Code, and any MCP-compatible client
• Conversion Options: Fine-tune output quality, resolution, bitrate, and more
• Secure: Uses your personal API key, no data stored on third-party servers beyond conversion processing

Popular Conversions

Here's what people actually use this for:

Browse all audio converters, video converters, image converters, and document converters.

Supported Formats

Requirements

• Node.js 18 or higher
• ConvertEverything.io API key — 100% FREE for all registered users!
  • Free account: 5 API calls/day
  • Bronze ($5.99/mo): 200 API calls/day
  • Silver ($9.99/mo): 400 API calls/day
  • Gold ($24.99/mo): Unlimited API calls

File Retention

Converted files are stored temporarily. Use the retention_hours parameter to control how long files are kept:

Default retention is 24 hours if not specified.

Installation

From npm (recommended)

npm install -g converteverything-mcp

From source

git clone https://github.com/converteverything/converteverything-mcp.git
cd converteverything-mcp
npm install
npm run build

Configuration

1. Get an API Key

1. Sign up at converteverything.io (it's free)
2. Go to API Keys and create a new key
3. Copy the key (starts with ce_)

API access is 100% free! All registered users get API access. Free tier: 5 calls/day. Upgrade for more.

2. Client Configuration

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

claude mcp add converteverything -- npx -y converteverything-mcp --api-key ce_your_key

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

{
  "converteverything": {
    "command": "npx",
    "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
  }
}

{
  "context_servers": {
    "converteverything": {
      "command": {
        "path": "npx",
        "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
      }
    }
  }
}

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
        }
      }
    ]
  }
}

# With API key as argument
npx converteverything-mcp --api-key ce_your_key

# With environment variable
export CONVERTEVERYTHING_API_KEY=ce_your_key
npx converteverything-mcp

# Short form
npx converteverything-mcp -k ce_your_key

Alternative: Environment Variables

All clients also support passing the API key via environment variable:

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp"],
      "env": {
        "CONVERTEVERYTHING_API_KEY": "ce_your_api_key_here"
      }
    }
  }
}

CLI Options

Available Tools

get_supported_formats

Get a list of all supported file formats organized by category.

User: What formats can you convert?
Claude: [Uses get_supported_formats] I can convert between 93+ formats including...

get_usage

Check your current API usage and limits.

User: How many conversions do I have left today?
Claude: [Uses get_usage] You've used 5 of your 100 daily conversions...

convert_file

Convert a file from one format to another.

User: Convert my-video.mov to mp4
Claude: [Uses convert_file] Starting conversion...

Parameters:

• file_path (required): Path to the file to convert
• target_format (required): Target format (e.g., "mp3", "pdf", "png")
• options (optional): Conversion settings (see below)

convert_base64

Convert a file provided as base64 data.

Parameters:

• data (required): Base64-encoded file data
• filename (required): Original filename with extension
• target_format (required): Target format
• options (optional): Conversion settings

get_conversion_status

Check the status of an ongoing conversion.

User: Is my conversion done yet?
Claude: [Uses get_conversion_status] Your conversion is complete and ready to download!

download_file

Download a completed conversion.

Parameters:

• conversion_id (required): The conversion ID
• save_path (optional): Path to save the file

list_presets

Get available conversion presets for quick configuration.

User: What presets are available?
Claude: [Uses list_presets] Here are the available presets:
- web-optimized: Smaller files, fast loading
- high-quality: Best quality, larger files
- balanced: Good quality with reasonable size
...

batch_convert

Convert multiple files at once.

User: Convert all the WAV files in my project to MP3
Claude: [Uses batch_convert] Converting 5 files to MP3...

Parameters:

• file_paths (required): Array of file paths to convert
• target_format (required): Target format for all files
• preset (optional): Use a preset (e.g., "web-optimized")
• options (optional): Conversion settings

wait_for_conversion

Wait for a conversion to complete with progress polling.

User: Convert this large video and let me know when it's done
Claude: [Uses convert_file, then wait_for_conversion] The conversion is now complete!

Parameters:

• conversion_id (required): The conversion ID to wait for
• poll_interval (optional): Milliseconds between status checks (default: 2000)
• timeout (optional): Max wait time in milliseconds (default: 300000)

list_conversions

List your recent conversions with pagination.

User: Show me my recent conversions
Claude: [Uses list_conversions] Here are your last 10 conversions...

Parameters:

• page (optional): Page number (default: 1)
• per_page (optional): Results per page, 1-100 (default: 10)

cancel_conversion

Delete a conversion and its associated files. Note: In-progress conversions cannot be cancelled.

User: Delete that failed conversion
Claude: [Uses cancel_conversion] Conversion deleted successfully.

Parameters:

• conversion_id (required): The conversion ID to delete

get_file_info

Get file metadata before conversion (size, format, MIME type).

User: What's the size of this video file?
Claude: [Uses get_file_info] The file is 1.2 GB, format: MP4, MIME: video/mp4

Parameters:

• file_path (required): Path to the file to analyze

estimate_output_size

Estimate the output file size before conversion.

User: How big will this WAV be as MP3?
Claude: [Uses estimate_output_size] Estimated output: ~15 MB (from 150 MB WAV at 128k bitrate)

Parameters:

• file_path (required): Path to the source file
• target_format (required): Target format
• options (optional): Conversion options that affect size
• preset (optional): Preset name

Compression Tools

compress_image

Compress an image file to reduce file size.

User: Compress this photo to make it smaller for email
Claude: [Uses compress_image] Compressed from 5.2 MB to 1.1 MB (79% reduction)

Parameters:

• file_path (required): Path to the image file
• quality (optional): Quality level 1-100 (default: 80)
• max_dimension (optional): Max width/height in pixels
• retention_hours (optional): File retention 1-720 hours (default: 24, max based on tier)

compress_video

Compress a video file to reduce file size.

User: Make this video smaller for uploading
Claude: [Uses compress_video] Compressed from 500 MB to 85 MB

Parameters:

• file_path (required): Path to the video file
• crf (optional): Quality 0-51, lower is better (default: 28)
• preset (optional): Speed preset (ultrafast, fast, medium, slow)
• max_resolution (optional): Max resolution (e.g., "1920x1080", "720p")
• remove_audio (optional): Remove audio track
• retention_hours (optional): File retention 1-720 hours (default: 24, max based on tier)

compress_pdf

Compress a PDF file to reduce file size.

User: This PDF is too large to email, can you compress it?
Claude: [Uses compress_pdf] Compressed from 25 MB to 3.2 MB

Parameters:

• file_path (required): Path to the PDF file
• quality (optional): Compression quality: low, medium, high (default: medium)
• retention_hours (optional): File retention 1-720 hours (default: 24, max based on tier)

get_compression_usage

Check your compression usage and limits.

User: How many compressions do I have left?
Claude: [Uses get_compression_usage] You've used 15 of 100 compressions today

Archive Tools

create_archive

Create an archive from multiple files.

User: Zip up all these project files
Claude: [Uses create_archive] Created project.zip with 12 files (45 MB)

Parameters:

• file_paths (required): Array of file paths to include
• output_format (optional): zip, tar, tar.gz, tar.bz2, or 7z (default: zip)
• archive_name (optional): Custom name for the archive
• compression_level (optional): 1-9 (default: 6)
• retention_hours (optional): File retention 1-720 hours (default: 24, max based on tier)

Advanced Conversion Tools

reconvert

Re-run a previous conversion with different settings.

User: Can you redo that last conversion but with higher quality?
Claude: [Uses reconvert] Re-converting with quality set to 95...

Parameters:

• conversion_id (required): ID of the previous conversion
• target_format (optional): New target format
• options (optional): New conversion options

get_thumbnail

Get a thumbnail preview for a conversion.

User: Show me a preview of that converted image
Claude: [Uses get_thumbnail] Here's a thumbnail preview...

Parameters:

• conversion_id (required): The conversion ID
• save_path (optional): Path to save the thumbnail

batch_convert_api

True batch conversion using the API's batch endpoint (more efficient for large batches).

User: Convert all 50 of these files to PDF
Claude: [Uses batch_convert_api] Batch started with ID batch_abc123...

Parameters:

• file_paths (required): Array of file paths
• target_format (required): Target format for all files
• options (optional): Conversion options

get_batch_status

Check the status of a batch conversion.

User: How's that batch conversion going?
Claude: [Uses get_batch_status] 45 of 50 complete, 5 still processing...

Parameters:

• batch_id (required): The batch ID

File Sharing Tools

list_my_files

List your shareable files.

User: What files do I have available to share?
Claude: [Uses list_my_files] You have 5 files ready to share...

Parameters:

• page (optional): Page number (default: 1)
• per_page (optional): Results per page (default: 20)

create_share_link

Create a shareable download link for a file.

User: Generate a link I can share for that converted video
Claude: [Uses create_share_link] Here's your shareable link: https://converteverything.io/s/abc123

Parameters:

• conversion_id (required): The conversion ID
• expires_hours (optional): Hours until link expires (default: 24)

share_via_email

Share a file directly via email.

User: Email that PDF to john@example.com
Claude: [Uses share_via_email] Email sent to john@example.com with download link

Parameters:

• conversion_id (required): The conversion ID
• recipient_email (required): Email address to send to
• message (optional): Custom message to include

Cloud Import Tools

list_cloud_providers

List available cloud storage providers.

User: What cloud services can I import from?
Claude: [Uses list_cloud_providers] You can import from Google Drive, Dropbox, OneDrive, and Box

list_cloud_connections

List your connected cloud storage accounts.

User: What cloud accounts do I have connected?
Claude: [Uses list_cloud_connections] You have Google Drive (user@gmail.com) connected

list_cloud_files

Browse files in a connected cloud storage account.

User: Show me the files in my Google Drive
Claude: [Uses list_cloud_files] Here are your Google Drive files...

Parameters:

• connection_id (required): Cloud connection ID
• folder_id (optional): Folder to browse (root if not specified)
• page_token (optional): For pagination

import_from_cloud

Import a file from cloud storage for conversion.

User: Import that video from my Dropbox and convert it to MP4
Claude: [Uses import_from_cloud, then convert_file] Importing and converting...

Parameters:

• connection_id (required): Cloud connection ID
• file_id (required): Cloud file ID
• target_format (optional): Convert immediately after import
• options (optional): Conversion options (if converting)

Conversion Presets

Presets provide pre-configured conversion settings optimized for different use cases. Use them with the preset parameter in convert_file, convert_base64, or batch_convert.

Preset Example

User: Convert my podcast.wav to MP3 for web
Claude: [Uses convert_file with preset: "web-optimized"]
Converting with web-optimized settings (128kbps, 44.1kHz stereo)...

User: Convert these photos for print
Claude: [Uses batch_convert with preset: "print-ready"]
Converting with print-ready settings (300 DPI, maximum quality)...

Conversion Options

Audio Options

Perfect for MP3 conversions, podcasts, and music:

{
  "bitrate": "320k",
  "sample_rate": 48000,
  "channels": 2,
  "normalize": true
}

Video Options

For video format conversions, streaming, and social media:

{
  "resolution": "1920x1080",
  "fps": 30,
  "crf": 23,
  "preset": "medium",
  "audio_bitrate": "192k",
  "remove_audio": false
}

Image Options

For image conversions, web optimization, and print:

{
  "quality": 90,
  "max_dimension": 2048,
  "strip_metadata": true,
  "dpi": 300
}

Document Options

For PDF conversions and office documents:

{
  "pdf_quality": "printer",
  "page_size": "a4",
  "orientation": "portrait"
}

MCP Resources

The server exposes format documentation as MCP Resources that AI assistants can read to understand supported formats.

Resources allow AI assistants to have contextual knowledge about supported formats without making API calls.

MCP Prompts

Pre-built prompts for common conversion tasks:

Example Conversations

Convert an image

User: Convert screenshot.png to a high-quality JPEG
Claude: I'll convert that PNG to JPEG for you with high quality settings.
[Uses convert_file with options: {"quality": 95}]
The conversion is complete! Your file has been converted to JPEG.

Convert a video

User: I need to convert this MOV file to MP4 for web use
Claude: I'll convert your MOV to MP4 with web-optimized settings.
[Uses convert_file with options: {"crf": 23, "preset": "medium"}]
Done! The MP4 is ready for download.

Batch conversion

User: Convert all the screenshots in ~/Desktop to JPG for the web
Claude: [Uses batch_convert with preset: "web-optimized"]
Converting 12 PNG files to JPG with web-optimized settings...
All 12 conversions started. I'll monitor their progress.
[Uses wait_for_conversion for each]
All done! 12 files converted successfully.

Check conversion history

User: What did I convert recently?
Claude: [Uses list_conversions]
Here are your last 10 conversions:
1. report.pdf → docx (completed, 2 hours ago)
2. video.mov → mp4 (completed, yesterday)
...

Format inquiry

User: What video formats can I convert to?
Claude: [Uses get_supported_formats]
You can convert to these video formats: mp4, avi, mkv, mov, webm, wmv, flv, m4v, 3gp, ts, vob, mts, mpeg, m2ts, divx

Large File Handling

As of version 2.1.0, the MCP server automatically handles large files using chunked uploads:

• Files > 30MB are automatically split into 10MB chunks
• Parallel uploads (3 concurrent) for faster transfer speeds
• Better reliability - failed chunks can be retried without restarting the entire upload
• Memory efficient - only one chunk is loaded into memory at a time

This is transparent to users - just use convert_file as normal and the server handles the rest.

User: Convert my 500MB video to MP4
Claude: [Uses convert_file - automatically uses chunked upload for large files]
Starting conversion... (uploading in 50 chunks)

Security

This MCP server:

• Only uses the public ConvertEverything.io API
• Requires your personal API key (never shared)
• Validates all file paths to prevent directory traversal
• Sanitizes filenames before upload
• Uses HTTPS for all API communication
• Does not store any files or credentials
• Uses chunked uploads for large files (>30MB) for reliability

Your files are:

• Encrypted in transit (HTTPS/TLS)
• Processed on ConvertEverything.io servers
• Automatically deleted after your tier's retention period (6 hours to 60 days)

Troubleshooting

"API key is required"

Make sure you've set the CONVERTEVERYTHING_API_KEY environment variable in your MCP configuration.

"Invalid API key format"

API keys must start with ce_. Get your key from converteverything.io/api-keys.

"Unsupported format"

Use get_supported_formats to see all available formats. Some format combinations may not be supported.

"Daily limit exceeded"

Your subscription tier has a daily conversion limit. Upgrade to Gold for unlimited conversions.

Pricing

API access is available to all registered users. Here's what you get:

👉 View Full Pricing | Get API Key

Annual plans save 25% — Gold annual works out to $18.74/month.

Development

# Clone the repository
git clone https://github.com/converteverything/converteverything-mcp.git
cd converteverything-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
CONVERTEVERYTHING_API_KEY=ce_your_key npm run dev

License

MIT License - see for details.

Links

• 🏠 ConvertEverything.io — Main site
• 📖 API Documentation — Full API docs
• 🔑 Get API Key — Manage your keys
• 💰 Pricing — Plans & features
• 🐛 GitHub Issues — Report bugs
• 📧 Contact — Get in touch

Built with 🔧 by the ConvertEverything.io team
_{Because life's too short for format incompatibility.}