# conv2pdf MCP server

> Converts Office files, images, e-books, and web pages to PDF, and provides tools to merge, split, compress, or protect PDF documents.

- Repository: https://github.com/conv2pdf/mcp
- Page: https://hostedmcp.org/servers/conv2pdf/mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.2.0

## Install

### Claude Code

```sh
claude mcp add --env 'CONV2PDF_API_KEY=<YOUR_CONV2PDF_API_KEY>' mcp -- npx -y conv2pdf-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "conv2pdf-mcp"
      ],
      "env": {
        "CONV2PDF_API_KEY": "<YOUR_CONV2PDF_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "conv2pdf-mcp"
      ],
      "env": {
        "CONV2PDF_API_KEY": "<YOUR_CONV2PDF_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","conv2pdf-mcp"],"env":{"CONV2PDF_API_KEY":"<YOUR_CONV2PDF_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "conv2pdf-mcp"
      ],
      "env": {
        "CONV2PDF_API_KEY": "<YOUR_CONV2PDF_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'CONV2PDF_API_KEY=<YOUR_CONV2PDF_API_KEY>' -- npx -y conv2pdf-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "conv2pdf-mcp"]

[mcp_servers.mcp.env]
CONV2PDF_API_KEY = "<YOUR_CONV2PDF_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'CONV2PDF_API_KEY=<YOUR_CONV2PDF_API_KEY>' mcp npx -- -y conv2pdf-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "conv2pdf-mcp"
      ],
      "env": {
        "CONV2PDF_API_KEY": "<YOUR_CONV2PDF_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CONV2PDF_API_KEY` | yes | yes | Conv2pdf API key, created in the Developer tab of the Conv2pdf dashboard |

## Tools (15)

- `convert_to_pdf`: Converts a document, an image, an e-book or a web page saved as a file to PDF: Word, Excel, PowerPoint, OpenDocument, Apple Pages, RTF, TXT, CSV, PNG, JPG, WebP, GIF, TIFF, HEIC, EPUB, PostScript (PS, EPS), XPS (XPS, OXPS) and HTML. The converter is chosen from the extension of the file. An HTML file is printed as a browser would print it. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `convert_url_to_pdf`: Converts the public web page at an address to PDF, as a browser prints it: the text stays selectable and the links work. The page is opened without a session, so a page behind a login is out of reach. The address is sent to Conv2pdf, which opens the page, and the call counts as one conversion.
- `convert_heic_to_jpg`: Converts an iPhone HEIC or HEIF photo to a JPG image. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `convert_pdf_to_word`: Converts a PDF that contains real text to an editable Word document (DOCX). A scanned PDF, made of images without text, is refused. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `convert_pdf_to_images`: Renders each page of a PDF as an image at 150 DPI. The result is one ZIP archive with an image per page. Up to 100 pages. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `merge_pdfs`: Combines several PDFs into one, in the order given. 2 files on the Dev plan, up to 20 on paid plans. The result is written next to the first file. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `extract_pdf_pages`: Copies the pages you list into a new PDF, in the order you write them. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `split_pdf`: Puts every page of a PDF in its own PDF file. The result is one ZIP archive, with page-001.pdf, page-002.pdf and so on. Up to 200 pages. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `rotate_pdf`: Rotates every page of a PDF clockwise. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `add_page_numbers`: Prints the page number at the bottom of every page of a PDF. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `add_watermark`: Stamps a text diagonally across every page of a PDF. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `compress_pdf`: Reduces the size of a PDF by lowering the resolution of its images. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `protect_pdf`: Encrypts a PDF (AES-256) so that it asks for a password to open, and optionally forbids printing or copying. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `unlock_pdf`: Removes the password and the restrictions of a PDF whose password is known. It does not find a forgotten password. The file is uploaded to Conv2pdf and the call counts as one conversion.
- `get_quota`: Returns the plan of the Conv2pdf API key and how many conversions it has used and may still use. Reading the quota is free. (read-only)

## FAQ

### What files can be converted to PDF?

You can convert Word, Excel, PowerPoint, OpenDocument, Apple Pages, RTF, TXT, CSV, PNG, JPG, WebP, GIF, TIFF, HEIC, EPUB, PostScript, or HTML files to PDF.

### Where is the file processing handled?

Processing is performed on OVHcloud servers in France, ensuring no data transfer outside the EU and no US services in the chain.

### How much can files weigh on the free plan?

Files can weigh up to 10 MB on the Dev plan.

### Does the server overwrite my existing files?

No, the server writes the result next to the input file or adds a suffix, and it will refuse to convert if the output filename is already taken.

### What is the rate limit for the API?

The API allows for 20 conversions per minute per API key.
