# convertica-net/convertica-mcp [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/convertica-net/convertica-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 273  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/convertica-net-convertica-mcp

## Description
Convert PDF ⇄ Word, Excel, PowerPoint, JPG, HTML, Markdown, EPUB and PDF/A, plus merge, split, compress, watermark, sign, and protect PDFs, and convert images (HEIC, WebP) — 35+ tools from convertica.net. Zero-config via npx convertica-mcp.

## Tools
Capabilities this server exposes over MCP:

- **list_converters** — List all available file conversion tools (PDF ⇄ Word/Excel/PowerPoint/JPG/HTML/Markdown/EPUB/PDF-A, merge/split/compress/protect PDF, image convert/optimize/HEIC, and more) with their input fields and options. Call this first to find the right `tool` value for convert_file.
- **convert_file** — Run one of convertica.net's 35+ conversion tools on local file(s) and save the result next to the input (or into output_dir). Requires authentication via the CONVERTICA_API_KEY env var. Use list_converters for tool slugs and options. Examples: {tool: 'pdf-to-word', files: ['/docs/report.pdf']}; {tool: 'pdf-organize/merge', files: ['/a.pdf','/b.pdf']}.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "convertica-mcp": {
    "command": "npx",
    "args": ["-y","convertica-mcp"],
    "env": {
      "CONVERTICA_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `CONVERTICA_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What convertica-net/convertica-mcp MCP server does

The convertica-net/convertica-mcp MCP server gives an MCP client access to more than 35 Convertica file-processing tools. It works with local files and supports document conversion, PDF operations, and image processing. Supported workflows include converting PDFs to or from Word, Excel, PowerPoint, JPG, HTML, Markdown, Text, and EPUB; creating PDF/A files; and converting HTML or URLs to PDF.

PDF operations include merging, splitting, compressing, rotating, cropping, watermarking, signing, protecting, and unlocking files. Image workflows include format conversion, optimization, and HEIC conversion to JPG, PNG, or PDF. The complete converter catalog is returned by the discovery tool rather than being hard-coded into the client workflow.

## How it works

The server exposes two MCP tools. Call `list_converters` without arguments to retrieve the available converter slugs, input fields, and option definitions. Use the returned `tool` value with `convert_file`; examples include `pdf-to-word` and `pdf-organize/merge`.

`convert_file` accepts local file paths, optional tool-specific options, and an optional output directory. For multi-file operations, the file order matters. By default, the generated result is written next to the first input file. Passing `output_dir` changes the destination.

The convertica-net/convertica-mcp MCP server sends conversion requests to Convertica over HTTPS and waits synchronously for the response. Files are read from and written to the local machine. Convertica states that processed files are deleted from its servers after the response. API usage counts against the account’s monthly quota, while failed calls are not counted.

## Setup and configuration

Install and run the server with the npm package through `npx`:

```bash
npx -y convertica-mcp
```

Set `CONVERTICA_API_KEY` in the MCP client environment. The key is obtained through Convertica’s account and API-key pages, and the README directs users to subscribe through Convertica’s pricing page before creating one.

For Claude Desktop, Cursor, or Windsurf, configure the server with the `npx` command, the `-y` and `convertica-mcp` arguments, and an environment entry containing the API key. Claude Code can add the same server with its MCP command and environment option. The repository also documents `npm install` and smoke-test commands for local development; the protocol smoke test does not require a key, while a real conversion does.

## Tools and capabilities

- `list_converters`: Lists available converters, file fields, and options. It takes no input.
- `convert_file`: Runs one converter against local file paths and saves the output locally.
- PDF, office-document, markup, ebook, and image format conversion.
- PDF merge, split, compression, rotation, cropping, watermarking, signing, protection, unlocking, and PDF/A conversion.
- HTML or URL rendering to PDF.
- Image conversion and optimization, including HEIC input handling.

The convertica-net/convertica-mcp MCP server is suited to assistants that need to act on files already available on the user’s machine. It is not described as a file browser or general-purpose storage service; its exposed operations center on conversion and related PDF or image processing.

## Limitations and notes

A valid `CONVERTICA_API_KEY` is required for conversion requests. The server depends on Convertica’s hosted service, so conversion calls require network access and are subject to the account’s monthly quota. Results are saved locally, but the source files must be available through paths supplied to `convert_file`. The README states that the server is MIT licensed and is not affiliated with Anthropic.

_Full upstream README: https://allmcps.com/mcp/convertica-net-convertica-mcp/readme_