convertapi-mcp
ConvertAPI MCP extension for file conversion and document processing workflows.
Open source Open in the app JSON README (API)
About
ConvertAPI MCP extension for file conversion and document processing workflows.
Details
- Kind
- Plugins
- Topic
- Files & documents
- Publisher
- convertapi
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 2
- Last push
- 2026-05-12T07:15:07Z
- Repository state
- ativo
- Language
- C#
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
convertapi/convertapi-mcp
README
# 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)