English Français العربية

Papyrio PDF Tools

Official registry Productivity

Compress, convert, merge, split and OCR PDFs from an assistant, using local files.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package papyrio-mcp
Claude Code 
claude mcp add papyrio-pdf-tools -e 'PAPYRIO_API_KEY=<your papyrio_api_key>' -- npx -y papyrio-mcp@0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "papyrio-pdf-tools": {
            "command": "npx",
            "args": [
                "-y",
                "papyrio-mcp@0.1.4"
            ],
            "env": {
                "PAPYRIO_API_KEY": "<your papyrio_api_key>"
            }
        }
    }
}

Environment variables

  • PAPYRIO_API_KEY secret RapidAPI subscription key. Without one the server runs on the free guest tier, which allows three operations a day per IP address.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. papyrio-mcp
  2. Install
  3. API key
  4. Tools
  5. Adding a tool
  6. Testing
  7. Develop
  8. Licence

papyrio-mcp

An MCP server for the Papyrio PDF API. Setup for Claude, Cursor and VS Code: papyrio.net/mcp. It lets an assistant compress, merge, OCR and convert PDFs on your own machine, reading and writing local files, so multi-step work does not mean uploading and downloading between every step.

OCR every scan in ~/invoices, merge them into one PDF, compress it under 5 MB

is four tool calls the assistant makes by itself.

Install

Claude Desktop, one click

Download papyrio-mcp.mcpb and double-click it. Claude Desktop opens an install screen; leave the API key empty for the free guest tier or paste a RapidAPI key (see below). You can change it later under Settings, Extensions.

By hand, or any other client

Add this to your Claude Desktop config:

macOS ~/Library/Application Support/Claude/claude_desktop_config.json Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"]
    }
  }
}

Restart Claude Desktop. The tools appear under the connector icon.

API key

The server works without one, metered as ordinary free web traffic: three operations a day per IP address. Enough to see whether it is useful.

For real use, subscribe on RapidAPI and pass the key:

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"],
      "env": { "PAPYRIO_API_KEY": "your-rapidapi-key" }
    }
  }
}

The free RapidAPI tier is 50 requests a month and needs no card.

Tools

ToolDoesWrites
compress_pdfShrinks a PDF, 30–80% on image-heavy files.pdf
merge_pdfsJoins 2–10 PDFs in order.pdf
split_pdfSeparates every page into its own file.zip
extract_pdf_textReturns the text layer as UTF-8.txt
pdf_to_wordRebuilds the document as an editable .docx.docx
pdf_to_jpgRenders every page as a JPG.zip
ocr_pdfAdds a searchable text layer to a scan; lang picks English, Russian, Spanish, Italian, Uzbek or Kazakh.pdf
office_to_pdfWord, PowerPoint or Excel to PDF.pdf
image_to_pdfWraps a JPG, PNG or WebP in a PDF page.pdf
webpage_to_pdfRenders a public URL in a headless browser.pdf
protect_pdfEncrypts with AES-256.pdf
unlock_pdfRemoves a password you already know.pdf

Every tool takes absolute paths. output_path is optional and defaults to the input name with a -papyrio suffix — except webpage_to_pdf, which has no input file to derive a name from and so requires it.

Adding a tool

Add an entry to src/tools.ts. The MCP tool, its input schema and the HTTP call are all generated from it.

Testing

npm run build
PAPYRIO_API_KEY=your-key node smoke.mjs

Drives all twelve tools over the real MCP protocol against the live API and checks the returned file's magic bytes, so a JSON error body named .pdf fails rather than passes. Without a key it runs on the guest tier, where three operations a day means most cases will hit rate_limit_exceeded.

Develop

npm install
npm run build

Point your config at the local build while working on it:

{
  "mcpServers": {
    "papyrio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

Privacy: files are sent to the Papyrio API, processed in memory, and discarded when the response is sent. Nothing is stored.

Licence

MIT

Frequently asked questions

What is Papyrio PDF Tools?

Compress, convert, merge, split and OCR PDFs from an assistant, using local files.

How do I install Papyrio PDF Tools?

It runs on your machine. In Claude Code: claude mcp add papyrio-pdf-tools -e 'PAPYRIO_API_KEY=<your papyrio_api_key>' -- npx -y papyrio-mcp@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Papyrio PDF Tools need an API key?

Yes. It expects PAPYRIO_API_KEY, which you set in its configuration.

Is Papyrio PDF Tools open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Papyrio PDF Tools?

It is published by atabekdemurtaza. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.