Contenta Converter MCP server

Lets an AI agent (Claude Code, Claude Desktop/Cowork, Codex, Cursor, VS Code and other MCP clients) use Contenta Converter on your Windows PC: batch image conversion, resizing, effects, metadata, PDF albums and slideshows for 100+ image formats.

Contenta Converter is a Windows 10/11 desktop app with a free trial: https://www.contenta-converter.com/download.php

How it works

This package is a small launcher. It finds Contenta Converter on your PC (contenta.exe, installed per-user in %LOCALAPPDATA%\Programs\ContentaConverter or on your PATH) and runs the app's own MCP server (contenta serve) over stdio. Tools: convert_image, batch_convert, ai_transform, create_pdf_album, create_slideshow, merge_pdfs, detect_format, list_effects, read_metadata, write_metadata.

If the app is not installed yet, the launcher serves a single get_started tool that gives your agent the download link and the install steps instead.

Add it to your client

Claude Code (Windows):

claude mcp add contenta-converter -- cmd /c npx -y @contentasoft/[email protected]

Claude Desktop, Cursor and other clients that use mcpServers (JSON):

{
  "mcpServers": {
    "contenta-converter": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/[email protected]"] }
  }
}

VS Code (.vscode/mcp.json, note the servers key):

{
  "servers": {
    "contenta-converter": { "type": "stdio", "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/[email protected]"] }
  }
}

Codex (codex mcp add contenta-converter -- cmd /c npx -y @contentasoft/[email protected], or ~/.codex/config.toml):

[mcp_servers.contenta-converter]
command = "cmd"
args = ["/c", "npx", "-y", "@contentasoft/[email protected]"]
startup_timeout_sec = 60
tool_timeout_sec = 3600

The first start downloads this small package, which can take longer than a client's default startup timeout (Codex: 10 s; Claude Code: set MCP_TIMEOUT); after that it starts at once. Long jobs such as video encodes can exceed a client's default tool timeout too (Codex: 60 s; Claude Code: MCP_TOOL_TIMEOUT). The app is told to stop a job when the client cancels it.

Once the app is installed you can also skip the launcher: "command": "contenta", "args": ["serve"].

What runs and what is sent

• The launcher itself sends nothing over the network and writes nothing to disk. It starts contenta.exe.
• The app works on local files on your PC. It sends anonymous usage telemetry (which tools ran, which MCP client connected, trial state) to ContentaSoft; turn it off in the app's settings. Privacy policy: https://www.contenta-converter.com/privacy.php
• ai_transform sends the image to Google Gemini with your own Gemini API key.
• The free trial has no end date: the first 10 outputs per PC come out clean, later ones carry a trial watermark (PDF albums, merged PDFs and slideshows are always marked on the trial). contenta status shows how many clean outputs are left; a batch spends one per file. Nothing stops working; a licence removes the limits.

License

The launcher is MIT-licensed (see LICENSE). Contenta Converter itself is commercial software by ContentaSoft AB.