Pdf4me MCP Server

PDF4me MCP Server

PDF4me MCP Server provides PDF4me API functionality through the Model Context Protocol (MCP), enabling AI assistants to easily perform a wide range of PDF, document, image, and barcode processing tasks.

---

🚀 Key Features

📄 PDF Conversion

• PDF → Office: Convert PDFs to Word (DOCX), Excel (XLSX), PowerPoint (PPTX)
• PDF → Other Formats: Convert PDFs to PDF/A, searchable OCR PDF, HTML, Markdown
• Office → PDF: Convert DOCX, PPTX, XLSX, CSV, HTML, Markdown, Visio, and images to PDF
• Word → PDF Form: Convert Word documents into fillable PDF forms
• JSON → Excel: Convert JSON data files into Excel workbooks

🛠️ PDF Editing & Modification

• Stamps & Watermarks: Add text or image stamps/watermarks to PDFs
• Headers & Footers: Inject HTML-based headers and footers
• Annotations: Add page numbers, margins, hyperlink annotations
• Attachments: Embed any file as an attachment inside a PDF
• Signing: Apply signature images to PDF pages
• Find & Replace: Search and replace text, or replace text with images

📐 PDF Organization

• Merge: Combine multiple PDFs or overlay two PDFs
• Split: Split by page, page range, barcode, Swiss QR code, or matching text
• Delete / Extract: Remove or extract specific pages, delete blank pages
• Rotate: Rotate all pages or selected pages of a PDF

🔍 PDF Extraction & Analysis

• Form Data: Extract values from fillable PDF form fields
• Tables: Detect and extract tables with coordinates
• Text: Extract text by regex expression; find and replace text
• Attachments: Pull embedded file attachments out of a PDF
• Resources: Extract text and images from PDF content
• Classification: Classify a PDF by document type, category, and confidence

🤖 AI Document Processing

• Invoices, Orders, Receipts: Structured data extraction using AI
• Bank Statements & Cheques: Parse financial documents automatically
• Contracts & Mortgage Documents: Extract key fields from legal documents
• Tax Documents & Pay Stubs: Parse tax forms and payroll documents
• ID & Cards: Process health cards, credit cards, marriage certificates, and shipping labels
• Universal Extraction: Generic AI data extraction from any document type

🏷️ Barcode & QR Codes

• Create: Generate barcodes and QR codes (PNG)
• Add to PDF: Stamp a barcode or QR code onto PDF pages
• Read from PDF / Image: Detect and decode barcodes and QR codes
• Swiss QR Bill: Create and read Swiss QR Bill payment sections; split PDFs by Swiss QR

🖼️ Image Processing

• Format Conversion: Convert between BMP, GIF, JPG, PNG, TIFF
• Editing: Resize, rotate, flip, and crop images
• Watermarks: Add image or text watermarks to images
• OCR: Extract text from images using OCR
• Metadata: Read or strip EXIF metadata
• Compression: Compress images with configurable quality levels

📝 Word & Document Tools

• Track Changes: Enable, disable, or extract tracked changes in Word documents
• Replace Text with Image: Substitute text placeholders with images in Word
• Extract Text: Pull text from Word documents with header/footer and comment control

📦 Document Generation

• Single Document: Generate one document from a template and data (JSON, XML, or plain text)
• Batch Documents: Generate multiple documents from a single template and dataset

🔒 Security

• Protect PDF: Apply password protection with configurable permissions
• Unlock PDF: Remove password protection from a PDF
• ZUGFeRD Invoice: Create standards-compliant ZUGFeRD e-invoices (XML or PDF+XML)

⚙️ Utilities

• Upload File: Upload local files to PDF4me cloud storage
• PDF Metadata: Read full metadata (title, author, page count, security info, dates)
• Image Metadata: Read image properties and EXIF fields
• Repair PDF: Repair corrupted or malformed PDFs
• Optimize PDF: Compress, linearize (web-optimize), or flatten PDFs

---

⚙️ Configuration

🔑 Get API Key

1. Sign up at dev.pdf4me.com
2. Get your API key from the dashboard

📦 Install UV

You need UV (a fast Python packaging tool) to run this MCP server.

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Alternative methods

# Homebrew (macOS)
brew install uv

# pipx
pipx install uv

# pip
pip install uv

For more options, see the UV installation guide.

---

🔧 MCP Client Setup

Cursor

Open Cursor Settings → MCP, or edit ~/.cursor/mcp.json (macOS/Linux) / %USERPROFILE%\.cursor\mcp.json (Windows):

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Open the Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code

Open ~/.config/Code/User/mcp.json (macOS/Linux) or %APPDATA%\Code\User\mcp.json (Windows):

{
  "servers": {
    "pdf4me-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Continue (VS Code / JetBrains extension)

Add to your ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "pdf4me-mcp",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  ]
}

---

🪟 Windows Note

On Windows, uvx may need to be called with its full path if it is not on your PATH. Replace "command": "uvx" with the full path, e.g.:

"command": "C:\\Users\\<YourUser>\\.local\\bin\\uvx"

---

🛠️ Available Tools

🏷️ Barcode Tools

---

🔄 Conversion Tools

---

✏️ PDF Editing Tools

---

📤 Extract Tools

---

📋 Forms Tools

---

📝 Document Generation Tools

---

🖼️ Image Tools

---

🔗 Merge & Split Tools

---

⚡ Optimize Tools

---

📂 Organize Tools

---

📊 PDF Information Tools

---

🔒 Security Tools

---

🤖 AI Document Processing Tools

---

📜 ZUGFeRD / E-Invoice Tools

---

🗂️ File Management Tools

---

💡 Usage Examples

Convert a PDF to Word:

Convert this PDF to a Word document: /path/to/document.pdf

Merge multiple PDFs:

Merge these PDFs into one: report.pdf, appendix.pdf, cover.pdf

Extract invoice data using AI:

Extract all invoice details from this file: invoice.pdf

Add a Swiss QR Bill to a PDF:

Add a Swiss QR Bill to invoice.pdf with IBAN CH93-0076-2011-6238-5295-7, creditor name "Acme AG"

Split a PDF by barcode:

Split this PDF at every page containing a Code128 barcode: batch.pdf

Generate a document from a template:

Generate a contract PDF from contract_template.docx with this data: {"client": "ACME", "date": "2024-01-01"}

Compress an image:

Compress this PNG image with maximum compression: photo.png

OCR a scanned PDF:

Make this scanned PDF searchable: scanned_report.pdf

---

🛠️ Manual Run (without a client)

uvx pdf4me-mcp

Or, if installed locally:

API_KEY=your-api-key-here pdf4me-mcp

---

📞 Support & Contact

• PDF4me: pdf4me.com
• API Documentation: docs.pdf4me.com
• Issue Reports: GitHub Issues

---

📄 License

This project is distributed under the MIT License.