Skip to main content
Glama

conv2pdf-mcp

Official Model Context Protocol server of the Conv2pdf API. Your AI assistant converts Word, Excel, PowerPoint, Pages, images, e-books, PostScript and HTML files to PDF, as well as web pages from their address, converts PDFs to Word or to images, and merges, splits, compresses, protects, rotates or numbers the PDFs that are on your computer. Processing runs on OVHcloud servers in France: no transfer outside the EU, no US service in the chain.

Installation · Tools · How it behaves · Development

Installation

  1. Create an account on conv2pdf.com. The Dev plan includes 300 free conversions, valid for 12 months; see pricing for the paid plans.

  2. Create an API key, which starts with cpdf_live_, in the Developer tab of your dashboard. Conv2pdf shows it only once, at creation.

  3. Add the server to your MCP client, with the key in the CONV2PDF_API_KEY environment variable. It needs Node.js 22 or later.

In Claude Code:

claude mcp add --env CONV2PDF_API_KEY=cpdf_live_... --transport stdio conv2pdf -- npx -y conv2pdf-mcp

On Windows, put cmd /c before npx.

In Claude Desktop, Cursor and the other clients configured with a JSON file:

{
  "mcpServers": {
    "conv2pdf": {
      "command": "npx",
      "args": ["-y", "conv2pdf-mcp"],
      "env": { "CONV2PDF_API_KEY": "cpdf_live_..." }
    }
  }
}

Or, in Claude Code, install the plugin: the same server, with a skill that tells the assistant which tool to call, in which order, and what a call costs.

/plugin marketplace add conv2pdf/mcp
/plugin install conv2pdf@conv2pdf

Claude Code asks for the API key when the plugin is enabled, and keeps it in the credential store of the system, not in a settings file. To set it later, run /plugin configure conv2pdf@conv2pdf, or open /plugin, Installed tab, conv2pdf, Configure options. A server you added by hand with the npx -y conv2pdf-mcp command takes precedence over the one of the plugin.

For another agent that loads SKILL.md skills, add the server as above and take the skill alone: plugin/skills/conv2pdf/SKILL.md in this repository, also listed on Agensi.

Then ask for what you need: "convert report.docx to PDF", "merge these three PDFs", "compress scan.pdf and protect it with a password".

Related MCP server: 1pdf

Tools

Tool

What it does

convert_to_pdf

Word, Excel, PowerPoint, OpenDocument, Apple Pages, RTF, TXT, CSV, PNG, JPG, WebP, GIF, TIFF, HEIC, EPUB, PostScript (PS, EPS) or HTML file to PDF, chosen from the extension

convert_url_to_pdf

Public web page to PDF, from its address, printed as a browser would

convert_heic_to_jpg

iPhone HEIC or HEIF photo to JPG

convert_pdf_to_word

PDF with real text to an editable DOCX document

convert_pdf_to_images

One PNG or JPG per page, in a ZIP file

merge_pdfs

Combine several PDFs into one, in the order given

extract_pdf_pages

Copy the pages you list, such as 1-5,7,10-12, into a new PDF, in the order written

split_pdf

One PDF per page, in a ZIP file

rotate_pdf

Turn every page by 90, 180 or 270 degrees

add_page_numbers

Number the pages, as "3 / 12" or "3", bottom center, left or right

add_watermark

Stamp a text of up to 50 characters on every page

compress_pdf

Reduce the size, keeping images at 72, 150 or 300 DPI

protect_pdf

Set a password, and optionally forbid printing or copying

unlock_pdf

Remove a password you know, or the printing and copying restrictions

get_quota

Plan, usage and limits of the API key

How it behaves

  • Files stay on your computer, except for the conversion. A tool takes the path of a file, sends the file to Conv2pdf and writes the result on your disk. Conv2pdf checks the content of the file, not only its name.

  • Nothing is overwritten. The result goes next to the input file: report.docx gives report.pdf, and a PDF tool adds a suffix, such as report-compressed.pdf. When that name is taken, the server writes report (2).pdf. The assistant can choose the place with output_path; if a file is already there, the tool refuses before converting anything. A web page has no input file to write next to, so convert_url_to_pdf always takes an output_path.

  • Deleted from the server. Once the result is on your disk, the server deletes the job from Conv2pdf. Should that fail, Conv2pdf deletes the files after one hour.

  • Quota. Each conversion counts as one in the quota of your plan, including one that Conv2pdf refuses after reading the file, such as an unreadable or scanned PDF, or one with too many pages. A file refused on arrival (wrong type, too large, password missing), a refused setting (a page range that does not exist, a password that is too short) and a failure on the side of Conv2pdf count for nothing, and get_quota is free. Files can weigh up to 10 MB on the Dev plan and 200 MB on paid plans.

  • Rate limit. The API accepts 20 conversions per minute per API key. When it asks to slow down, or when its queue is full, the server waits for the delay the API gives and tries again, twice at most and only for delays of 30 seconds or less; otherwise the assistant gets the delay to wait.

  • Protected PDFs. The tools that read a PDF, except merge_pdfs, open one that asks for a password when the assistant passes it as password. The result has no password. For a merge, unlock the protected PDFs first.

  • Pages and Numbers. A Pages document keeps its .pages extension: only the name tells it from a Numbers spreadsheet, which Conv2pdf does not convert, like Keynote presentations.

  • Errors. A refusal comes back to the assistant as a sentence it can act on: the wrong password, the page range that does not exist, the plan limit, the key to set. A cancelled call stops the transfer and leaves no file behind.

  • Without a key. The server starts and lists its tools; a call explains how to set CONV2PDF_API_KEY.

Every request carries User-Agent: conv2pdf-mcp/<version>. Mention it when you contact support: it tells your calls apart in the API's logs.

Development

The server has no dependency: Node.js runs the sources as they are. It talks to its client over stdio and serves both eras of the protocol from the same process: revision 2026-07-28, where each request carries its protocol version, and the earlier revisions (2025-11-25 down to 2024-11-05), which start with an initialize handshake.

npm test

runs the tests against a fake Conv2pdf API on a local port: no key and no network are needed.

The tools of the server and the extensions convert_to_pdf routes on follow what the live API publishes (GET /v1/tools): our monitoring compares them every day, and says when the API gains a tool or an extension that the server does not have.

Plugin

plugin/ holds the Claude Code plugin: its manifest, the .mcp.json that starts the published package with npx, and the skill, plugin/skills/conv2pdf/SKILL.md. .claude-plugin/marketplace.json is the catalog that lets Claude Code install the plugin from this repository. Neither is part of the npm package. npm test checks that the plugin is at the version of the package and that the skill names the tools the server has.

claude plugin validate . --strict
claude --plugin-dir ./plugin

check the manifests, then start a session with the plugin loaded from the folder, without installing it. A user gets a change of the plugin or of the skill when the version changes: it ships with a release.

Releasing

  1. Set the version in package.json, server.json and plugin/.claude-plugin/plugin.json, and date its section in CHANGELOG.md.

  2. Run npm test.

  3. Commit, then push a tag named after the version: the Publish workflow publishes the package to npm through Trusted Publishing, with a provenance statement.

  4. Publish the entry of the MCP Registry: mcp-publisher login http --domain conv2pdf.com, then mcp-publisher publish. The name com.conv2pdf/conv2pdf is proved by the public key served at https://conv2pdf.com/.well-known/mcp-registry-auth.

  5. When the skill changed, upload it again to its Agensi listing, as a new version: a ZIP of a conv2pdf/ folder that holds the SKILL.md. Nothing updates the listing from this repository.

Resources

Support

Open an issue or write to contact@conv2pdf.com.

License

MIT, see LICENSE.

Available Tools

13 tools
add_page_numbersAdd Page Numbers to PDFA

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.

Inputs: input_path (required), format, password, position, +1 more.

add_watermarkAdd Watermark to PDFA

Stamps a text diagonally across every page of a PDF. The file is uploaded to conv2pdf and the call counts as one conversion.

Inputs: text (required), input_path (required), password, output_path.

compress_pdfCompress PDFA

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.

Inputs: input_path (required), quality, password, output_path.

convert_heic_to_jpgConvert HEIC to JPGA

Converts an iPhone HEIC or HEIF photo to a JPG image. The file is uploaded to conv2pdf and the call counts as one conversion.

Inputs: input_path (required), output_path.

convert_pdf_to_imagesConvert PDF to ImagesA

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.

Inputs: input_path (required), format, password, output_path.

convert_pdf_to_wordConvert PDF to WordA

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.

Inputs: input_path (required), password, output_path.

convert_to_pdfConvert to PDFA

Converts a document, an image or an e-book to PDF: Word, Excel, PowerPoint, OpenDocument, Apple Pages, RTF, TXT, CSV, PNG, JPG, WebP, GIF, TIFF, HEIC and EPUB. The converter is chosen from the extension of the file. The file is uploaded to conv2pdf and the call counts as one conversion.

Inputs: input_path (required), output_path.

extract_pdf_pagesExtract Pages From PDFA

Keeps some pages of a PDF in a new PDF. The pages keep the order they have in the document. The file is uploaded to conv2pdf and the call counts as one conversion.

Inputs: pages (required), input_path (required), password, output_path.

get_quotaGet QuotaA
Read-only

Returns the plan of the conv2pdf API key and how many conversions it has used and may still use. Reading the quota is free.

merge_pdfsMerge PDFsA

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.

Inputs: input_paths (required), output_path.

protect_pdfProtect PDF With PasswordA

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.

Inputs: password (required), input_path (required), output_path, prevent_copy, +1 more.

rotate_pdfRotate PDFA

Rotates every page of a PDF clockwise. The file is uploaded to conv2pdf and the call counts as one conversion.

Inputs: rotation (required), input_path (required), password, output_path.

unlock_pdfUnlock PDFA

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.

Inputs: input_path (required), password, output_path.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a clearly distinct operation: input-side conversions (convert_to_pdf, convert_heic_to_jpg), output-side conversions (convert_pdf_to_word, convert_pdf_to_images), and discrete PDF edits (merge, extract, rotate, watermark, compress, protect, unlock). The only superficially adjacent pair (convert_to_pdf handling HEIC/JPG vs convert_heic_to_jpg producing PNG/JPG) differs clearly in direction and output format.

    Naming Consistency5/5

    All 13 tools use snake_case with a consistent verb-first convention (convert_*, merge_pdfs, extract_pdf_pages, rotate_pdf, add_*, compress_pdf, protect_pdf, unlock_pdf, get_quota). No camelCase or mixed-style outliers.

    Tool Count5/5

    13 tools is well-scoped for a PDF conversion and manipulation service, with each tool mapping to a genuine, non-redundant operation. No filler or trivially duplicated tools.

    Completeness4/5

    Strong coverage of the core lifecycle: conversion both directions, merge, page extraction, rotation, annotation (watermark, numbering), compression, encryption and decryption, plus quota checking. Minor gaps remain (e.g. PDF to text/Excel, splitting into separate per-page files, page deletion/reordering), but the surface covers nearly all common workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A local-first PDF tool for merging, splitting, rotating, watermarking, Bates-numbering, cleaning metadata, and counting pages — all operations happen on your machine with no network transmission.
      15
      13 npm
      1
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables AI assistants to perform PDF operations like merge, split, compress, convert, encrypt, OCR, and summarize using natural language.
      98
      15 npm
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      Enables local, offline document extraction and manipulation—PDF first but also HTML, DOCX, XLSX, PPTX, EML, EPUB, Markdown, and plain text—through tools for probing, locating, extracting, converting, assembling, OCR, protecting, and redacting documents, with nothing leaving the machine.
      7
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to convert documents, images, and data files across 50+ format pairs and to run PDF/image operations such as merge, split, compress, rotate, protect, unlock, extract text, and resize or compress images. Files are passed URL-in and returned URL-out (or saved locally in stdio mode), with tools for checking credits and generating Stripe checkout or billing-portal links.
      18
      50 PyPI
      MIT