Catalog›Plugins›Files & documents›convertapi-mcpCMconvertapi-mcpConvertAPI MCP extension for file conversion and document processing workflows. Open site Open in the app JSON README (API)READMELoading documentation…# ConvertAPI MCP Server > Our hosted MCP server is available at https://mcp.convertapi.io - read more about it in the [Hosted MCP section below](#prefer-a-hosted-mcp-no-setup-required). A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that provides AI assistants with powerful file format conversion capabilities through the [ConvertAPI](https://www.convertapi.com/) service. Convert documents, images, spreadsheets, presentations, and more between 200+ file formats with OpenAPI-driven parameter validation. ## Features - 🔄 **Universal File Conversion** - Convert between 200+ file formats (PDF, DOCX, XLSX, JPG, PNG, HTML, and more) - ✅ **OpenAPI-Driven Validation** - Dynamic parameter validation against ConvertAPI's live OpenAPI specification - 🎯 **Comprehensive Parameters** - Supports all ConvertAPI parameters including PageSize, PageOrientation, Quality, StoreFile, etc. - 🤖 **AI-Ready** - Seamlessly integrates with Claude Desktop, Cline, and other MCP-compatible AI assistants - 📦 **Local** - Supports local file operations ## Installation ### Prerequisites - .NET 9.0 SDK or later - A ConvertAPI account and API Token ([Get one free](https://www.convertapi.com/a/authentication)) ### Configuration 1. Clone the repository: git clone https://github.com/ConvertAPI/convertapi-mcp cd ConvertAPI-MCP 2. Set your ConvertAPI API Token as an environment variable: **Windows (PowerShell):** $env:CONVERTAPI_TOKEN = "your_api_token_here" $env:CONVERTAPI_BASE_URI = "https://v2.convertapi.com" **Linux/macOS:** export CONVERTAPI_TOKEN="your_api_token_here" export CONVERTAPI_BASE_URI="https://v2.convertapi.com" 3. Build the project: dotnet build ## Usage **Configuration:** Set the following in your application configuration: **Local Mode (with file download):** dotnet run --project "CA.MCP.Local" ## Integration with AI Assistants ### Claude Desktop Configuration Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "convertapi": { "command": "dotnet", "args": [ "run", "--project", "C:\\Path\\To\\CA.MCP.Local\\CA.MCP.Local.csproj", "--no-build" ], "env": { "CONVERTAPI_TOKEN": "your_api_token_here", "CONVERTAPI_BASE_URI": "https://v2.convertapi.com" } } } } ``` ### Cline (VSCode Extension) Add to your MCP settings in Cline: ```json { "convertapi": { "command": "dotnet", "args": [ "run", "--project", "/path/to/CA.MCP.Local", "--no-build" ], "env": { "CONVERTAPI_TOKEN": "your_api_token_here", "CONVERTAPI_BASE_URI": "https://v2.convertapi.com" } } } ``` ## Prefer a Hosted MCP? (No Setup Required) If you do not want to install .NET or run your own server, you can use the **hosted ConvertAPI MCP** instead. **Hosted endpoint:** https://mcp.convertapi.io Just configure your MCP client to use the hosted endpoint and provide your ConvertAPI API Token. ### Example (Claude Desktop) ```json { "mcpServers": { "convertapi": { "url": "https://mcp.convertapi.io", "env": { "CONVERTAPI_TOKEN": "your_api_token_here" } } } } ``` That’s it. Your AI agent can immediately start converting documents across 200+ formats using structured MCP tool calls. If you need full control, private networking, or custom deployment, continue with the self-hosted setup. ## Available Tools ### `Convert` Dynamically converts files between formats with OpenAPI-driven parameter validation. **Parameters:** - `fromFormat` (required) - Source format (e.g., "docx", "xlsx", "jpg") - `toFormat` (required) - Target format (e.g., "pdf", "png", "html") - `parameters` (optional) - Conversion parameters as key-value pairs - `fileParameters` (optional) - Files to convert with parameter names - `outputDirectory` (optional) - Directory to save converted files (Local mode only) **Example Usage in AI Assistant:** Convert this Word document to PDF: • From: docx • To: pdf • File: C:\Documents\report.docx • Parameters: PageSize=A4, PageOrientation=portrait ### `Information` Provides information about ConvertAPI capabilities, supported formats, and usage guidelines. ## Supported Conversions ConvertAPI supports 200+ file formats across multiple categories: - **Documents**: PDF, DOCX, DOC, RTF, TXT, ODT, PAGES - **Spreadsheets**: XLSX, XLS, CSV, ODS, NUMBERS - **Presentations**: PPTX, PPT, ODP, KEY - **Images**: JPG, PNG, GIF, BMP, TIFF, SVG, WEBP, ICO - **Web**: HTML, MHTML, MHT - **eBooks**: EPUB, MOBI, AZW3 - **Archives**: ZIP, RAR, 7Z - And many more... ## Common Conversion Parameters Depending on the conversion type, you can use parameters such as: - **PDF Options**: `PageSize`, `PageOrientation`, `MarginTop`, `MarginBottom`, `MarginLeft`, `MarginRight` - **Image Options**: `Quality`, `ImageWidth`, `ImageHeight`, `ScaleImage`, `ScaleProportions` - **General**: `StoreFile`, `FileName`, `Timeout` The server automatically validates parameters against ConvertAPI's OpenAPI specification before conversion. ## Claude Code Plugin In addition to a self-hosted MCP server, this repository provides a Claude Code plugin that connects Claude to ConvertAPI via MCP. ### What it enables - Convert files between different formats directly from Claude - Automate document and image processing, extraxction, and transformations ### Example usage - "Convert this PDF to DOCX" - "Merge these PDF files and apply a [Draft] watermark" - "Redact sensitive financial information on this PDF" - "Make this PDF print-ready with bleed and cropmarks" ### Setup - Install plugin in Claude Code - Authenticate via OAuth ## Contributing Contributions are welcome! Please feel free to submit a Pull Request. ## License This project is licensed under the MIT License - see the LICENSE file for details. ## Resources - [ConvertAPI Documentation](https://www.convertapi.com/doc) - [Model Context Protocol Specification](https://modelcontextprotocol.io) - [ConvertAPI .NET SDK](https://github.com/ConvertAPI/convertapi-dotnet) ## Acknowledgments - Built with the [ModelContextProtocol.NET](https://github.com/modelcontextprotocol/servers) library - Powered by [ConvertAPI](https://www.convertapi.com/) ## Support For issues and questions: - ConvertAPI support: [support@convertapi.com](mailto:support@convertapi.com) - GitHub Issues: [Report an issue](https://github.com/ConvertAPI/convertapi-mcp/issues) DetailsTypePluginsTopicFiles & documentsPublisherconvertapiSourcegeminiCategoryToolsVersion1.0.0Stars3Proposed changes1Last updateNov 10, 20265 days agoProject statusActiveLanguageC#AddedAug 30, 20263 months agoUpdatedAug 30, 20263 months agoSource idconvertapi/convertapi-mcpMoreMore plugins on Files & documentsAll from convertapiA–Z index
