Integrations

MCP Server

Use CloudConvert file processing tools from ChatGPT, Claude, and other MCP clients.

CloudConvert MCP Server

The CloudConvert MCP Server connects AI assistants to the CloudConvert API through the Model Context Protocol. It lets an assistant inspect supported formats, process attached files, build multi-step jobs, monitor their progress, and return download links for completed files.

Use the hosted server:

https://mcp.cloudconvert.com

The server uses the Streamable HTTP transport. You do not need to install or run a local package.

Tool availability and support for passing file attachments depend on the MCP client. Processing files consumes CloudConvert credits unless the tool description says otherwise.

Authentication

The MCP Server uses OAuth 2.0 with your CloudConvert account. When your MCP client connects for the first time, it opens CloudConvert so you can sign in and authorize access.

The server requires these scopes:

user.read to show account information and remaining credits
task.read to inspect jobs, tasks, and results
task.write to create, cancel, retry, and delete jobs and tasks

The webhook tools additionally use these scopes:

webhook.read to list webhooks
webhook.write to create and delete webhooks

If an authorization does not include the webhook scopes, the webhook tools return a permission error while all other tools keep working.

You do not need to create or paste an API key into ChatGPT or Claude. You can revoke an authorized application from your CloudConvert account at any time.

Only connect the URL https://mcp.cloudconvert.com. A connected MCP server can receive the files and information you send to its tools.

Install in ChatGPT

There is an official ChatGPT Plugin available in the offical Plugin Directory. It automatically installs the MCP server.

Custom MCP servers are connected as developer-mode apps in ChatGPT.

Open ChatGPT on the web and go to Settings → Apps.
Open Advanced settings and enable Developer mode. In a managed workspace, an administrator may need to enable developer mode first.
Select Create app.
Enter CloudConvert as the name and https://mcp.cloudconvert.com as the MCP server URL.
Select Create or Scan tools.
Sign in to CloudConvert and approve the requested access.
Start a new chat, add the CloudConvert app, attach a file, and ask ChatGPT to process it.

ChatGPT support for custom apps depends on your plan and workspace settings. The initial setup is completed on the web; after the app is connected, it may also be available in other ChatGPT clients.

Install in Claude

Free, Pro, and Max

Open Customize → Connectors in Claude.
Select + → Add custom connector.
Enter CloudConvert as the name and https://mcp.cloudconvert.com as the remote MCP server URL.
Select Add. Leave the optional OAuth Client ID and Client Secret fields empty.
Sign in to CloudConvert and approve the requested access.
Enable CloudConvert in a conversation and ask Claude to use one of its available tools.

Team and Enterprise

An Owner or Primary Owner must first add CloudConvert from Organization settings → Connectors:

Select Add, then choose Custom → Web.
Enter https://mcp.cloudconvert.com as the remote MCP server URL.
Leave the optional OAuth Client ID and Client Secret fields empty, then select Add.
Organization members can then enable the connector and authorize their own CloudConvert accounts.

Attached files

Claude uploads files you attach in a chat from its code execution environment to CloudConvert, and downloads the results back into the chat. This requires two settings in Settings → Capabilities:

Enable code execution and file creation.
Allow network access to *.storage.cloudconvert.com, for example by adding it to the allowed domains. Uploads and downloads go to the CloudConvert storage of your region, such as eu-central.storage.cloudconvert.com.

On Team and Enterprise plans, an Owner configures network access for the organization in Organization settings → Capabilities.

If network access to *.storage.cloudconvert.com is blocked, Claude can't upload the file and asks you to allow the domain. Files that are already available through a public URL work without these settings.

Available tools

File processing

Tool	Description
`convertFile`	Convert a file to another supported format.
`optimizeFile`	Compress and optimize PDF, PNG, or JPG files.
`addWatermarkToFile`	Add a text or image watermark to a PDF, image, or video.
`captureWebsite`	Convert a public website to PDF or capture a PNG or JPG screenshot.
`createThumbnail`	Create a PNG, JPG, or WEBP thumbnail from a file.
`mergeFiles`	Combine two or more files into one PDF, converting non-PDF inputs automatically.
`createArchive`	Package files as ZIP, RAR, 7Z, TAR, TAR.GZ, or TAR.BZ2.
`extractFileMetadata`	Read ExifTool metadata such as page count, dimensions, and media information. This tool does not consume conversion credits.
`writeFileMetadata`	Write XMP or IPTC metadata such as title, author, creator, producer, or copyright.
`executeCommand`	Run a custom FFmpeg, ImageMagick, or GraphicsMagick command.

PDF processing

Tool	Description
`pdfA`	Convert a PDF to the PDF/A-1b, PDF/A-2b, or PDF/A-3b archival standard.
`pdfX`	Convert a PDF to the PDF/X-1a, PDF/X-3, or PDF/X-4 print standard.
`pdfRotatePages`	Rotate selected pages or every page in a PDF.
`pdfOcr`	Add a searchable and copyable OCR text layer to a scanned PDF.
`pdfEncrypt`	Add passwords and security restrictions to a PDF.
`pdfDecrypt`	Remove password protection from a PDF using its current password.
`pdfSplitPages`	Split a PDF into one PDF file per page.
`pdfExtractPages`	Extract selected pages or page ranges into a new PDF.

Jobs and discovery

Tool	Description
`getUser`	Show information about the authenticated user and their remaining credits.
`getOperations`	Discover supported CloudConvert operations, input and output formats, engines, and options.
`createJob`	Create an advanced CloudConvert job from an arbitrary task graph.
`getJobs`	List jobs, with optional status and tag filters, task details, and pagination.
`getJob`	Check a job's status and retrieve its results by job ID, optionally waiting until it has finished.
`deleteJob`	Delete a job, including all of its tasks and files.
`getTasks`	List tasks, with optional job, status, and operation filters, and pagination.
`getTask`	Check an individual task's status and retrieve its results by task ID, optionally waiting until it has finished. Can include the task payload, its job, its input tasks, and its retries.
`cancelTask`	Cancel a waiting or processing task.
`retryTask`	Run a task again as a new task with the same payload.
`deleteTask`	Delete a task, including its files.

Webhooks

Tool	Description
`getWebhooks`	List account-wide webhooks with their URL, events, failure status, and signing secret.
`createWebhook`	Create an account-wide webhook for the `job.created`, `job.finished`, or `job.failed` events.
`deleteWebhook`	Delete an account-wide webhook.

For advanced requests, the assistant can call getOperations first to discover format-specific options, then use createJob to compose a custom multi-step workflow.

Example prompts

“Convert this DOCX file to PDF.”
“Compress this PDF while keeping it suitable for printing.”
“Merge these files in the order I attached them and return one PDF.”
“Make this scanned German PDF searchable with OCR.”
“Add a semi-transparent ‘Draft’ watermark to every page.”
“Capture this webpage as an A4 PDF.”

Completed tools return secure HTTPS download links. These output links are valid for 24 hours, and CloudConvert automatically deletes processed files according to its file retention policy.

Limitations

Tools that accept input files require each file to be available through a downloadable HTTP or HTTPS URL, or to be uploaded to an import/upload task. How attached files reach CloudConvert depends on the MCP client:

ChatGPT turns attached files into temporary download URLs, so attachments work with every tool without any setup.
Claude uploads attached files from its code execution environment. It creates a job with an import/upload task through createJob, uploads the file with the upload command returned by the tool, and waits for the job with getJob. This requires code execution and network access to CloudConvert, as described in Attached files.
Other clients that provide attachments as download URLs work like ChatGPT. Clients that can run shell commands, such as coding agents, can upload local files like Claude: createJob returns a ready-to-run curl command for each import/upload task, and getTask shows it again while the task is waiting for its file.
Clients that neither provide download URLs for attachments nor can run commands can only process files that are already available through a public URL.

This is a current limitation of file handling in the MCP protocol, which does not yet define an interoperable way to transfer files between clients and servers. Proposals such as SEP-2631: File Objects and Transfer aim to add first-class file inputs, outputs, and transfer negotiation. SEP-2631 is still a draft, so its design may change before adoption.

Export Files

Export files from the CloudConvert service to external storages or temporary download URLs

Signed URLs

Convert files on demand using URL query parameters.