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

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

📦 Install UV

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

macOS / Linux

Terminal

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

Windows (PowerShell)

powershell

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

Alternative methods

bash

# 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):

config.json

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_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

config.json

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

VS Code

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

config.json

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

Windsurf

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

config.json

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

Continue (VS Code / JetBrains extension)

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

config.json

{
  "mcpServers": [
    {
      "name": "pdf4me-mcp",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_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.:

json

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

🛠️ Available Tools

🏷️ Barcode Tools

Tool	Description
`add_barcode_to_pdf`	Draw a barcode or QR code onto PDF pages with configurable alignment and size
`create_barcode`	Generate a barcode or QR code as a PNG image (supports Code128, QR, and more)
`read_barcodes`	Read and decode barcode/QR data from a local PDF with barcode type and page filtering
`read_barcodes_from_image`	Detect and decode barcodes and QR codes from a local image file
`create_swiss_qr_bill`	Add a Swiss QR Bill payment section to a PDF (IBAN, creditor details, currency, reference)
`read_swiss_qr_bill`	Parse and extract Swiss QR Bill payment data from a local PDF
`split_pdf_by_barcode`	Split a PDF into multiple files at pages that contain a specific barcode value or type
`split_pdf_by_swiss_qr`	Split a PDF by Swiss QR code positions into separate PDF files or a ZIP archive

🔄 Conversion Tools

Tool	Description
`convert_to_pdf`	Convert documents (DOCX, PPTX, XLSX, images, text formats) to PDF
`convert_html_to_pdf`	Convert a local HTML file to PDF with layout, margins, and print options
`convert_url_to_pdf`	Convert a web page URL to PDF with auth, layout, and margin settings
`convert_md_to_pdf`	Convert a local Markdown file to PDF
`convert_visio_to_pdf`	Convert a Visio file (.vsdx/.vsd/.vsdm) to PDF
`convert_word_to_pdf_form`	Convert a Word document (DOCX) into a fillable PDF form
`convert_pdf_to_word`	Convert a PDF to DOCX with quality settings, language, and optional OCR
`convert_pdf_to_excel`	Convert a PDF to XLSX with quality, merge sheets, language, and optional OCR
`convert_pdf_to_powerpoint`	Convert a PDF to PPTX with quality, language, and optional OCR
`convert_pdf_to_pdfa`	Convert a PDF to PDF/A (PdfA1a through PdfA3u) with upgrade/downgrade control
`convert_ocr_pdf`	Make a scanned PDF searchable by running OCR and embedding a text layer
`convert_json_to_excel`	Convert a local JSON file to an Excel workbook (XLSX) with worksheet name and title options
`convert_image_format`	Convert images between BMP, GIF, JPG, PNG, and TIFF formats
`flatten_pdf`	Flatten a PDF (merge form fields and annotations into the page content)
`linearize_pdf`	Linearize (web-optimize) a PDF for fast browser loading with configurable optimization presets

✏️ PDF Editing Tools

Tool	Description
`add_attachment_to_pdf`	Embed one or more files as attachments inside a PDF
`add_html_header_footer_to_pdf`	Add an HTML-formatted header, footer, or both to PDF pages
`add_margin_to_pdf`	Add page margins (in millimeters) to all pages of a PDF
`add_page_number_to_pdf`	Insert page numbers with configurable alignment, format, and font styling
`add_image_stamp_to_pdf`	Place an image stamp or watermark on PDF pages with alignment, opacity, and size controls
`add_text_stamp_to_pdf`	Place a text stamp or watermark on PDF pages with font, opacity, rotation, and alignment options
`sign_pdf`	Apply a signature image to a PDF with layout and margin options
`find_and_replace_text`	Find and replace text across PDF pages
`replace_text_with_image`	Replace text occurrences in a PDF with an image at configurable dimensions
`update_hyperlink_annotation`	Update or replace hyperlink annotations in a PDF by search criteria
`repair_pdf`	Repair a corrupted or malformed PDF file

📤 Extract Tools

Tool	Description
`extract_pages_from_pdf`	Extract specific pages from a PDF into a new PDF file
`extract_form_data_from_pdf`	Extract all form field names and their current values from a PDF
`extract_attachment_from_pdf`	Extract embedded file attachments from a PDF and save them to disk
`extract_resources`	Extract text content and images embedded in a PDF
`extract_table_from_pdf`	Detect and extract tables from a PDF, saving results as JSON and CSV
`extract_text_by_expression`	Extract text from a PDF using a regular expression pattern
`extract_text_from_word`	Extract text from a Word document, with options to remove headers, footers, or comments
`extract_text_from_image`	Extract text from an image using OCR
`classify_document`	Classify a PDF by document type and category with a confidence score
`parse_document`	Extract structured data from a PDF using a predefined PDF4me parsing template

📋 Forms Tools

Tool	Description
`add_form_fields_to_pdf`	Add new TextBox or CheckBox form fields to a PDF at specified coordinates
`fill_pdf_form`	Fill existing form fields in a PDF using a key/value data map

📝 Document Generation Tools

Tool	Description
`generate_document_single`	Generate one document from a template (DOCX/HTML/PDF) and a data payload (JSON/XML/text)
`generate_documents_multiple`	Generate multiple documents in batch from one template and a multi-record dataset
`enable_tracking_changes_in_word`	Enable Track Changes mode in a Word document
`disable_tracking_changes_in_word`	Disable Track Changes mode in a Word document
`get_tracking_changes_in_word`	Extract all tracked change data from a Word document as structured JSON
`replace_text_with_image_in_word`	Replace text placeholders in a Word document with an image

🖼️ Image Tools

Tool	Description
`add_image_watermark_to_image`	Overlay a watermark image onto another image with opacity and position controls
`add_text_watermark_to_image`	Add a text watermark to an image with font, color, opacity, and rotation options
`compress_image`	Compress a JPG, PNG, or WebP image with configurable compression level
`convert_image_format`	Convert an image between BMP, GIF, JPG, PNG, and TIFF formats
`create_images_from_pdf`	Render PDF pages to image files (JPEG, PNG, TIFF) with page selection and width options
`crop_image`	Crop an image by border or by a specific rectangle region
`flip_image`	Flip an image horizontally or vertically
`get_image_metadata`	Extract image properties and EXIF metadata from a JPG or PNG file
`extract_text_from_image`	Run OCR on an image to extract its text content
`resize_image`	Resize an image by percentage or to specific dimensions, with aspect ratio control
`rotate_image`	Rotate an image by a specified angle with background color and resize options
`rotate_image_by_exif_data`	Auto-rotate an image to its correct orientation based on its EXIF metadata
`remove_exif_tags_from_image`	Strip all EXIF metadata from a JPG or PNG image

🔗 Merge & Split Tools

Tool	Description
`merge_multiple_pdfs`	Merge two or more PDF files into a single PDF
`merge_pdf_overlay`	Overlay one PDF on top of another (e.g. stamp a letterhead)
`split_pdf`	Split a PDF by page number, recurring interval, sequence, or page ranges
`split_pdf_by_barcode`	Split a PDF at pages containing a specified barcode
`split_pdf_by_swiss_qr`	Split a PDF at Swiss QR code positions
`split_pdf_by_text`	Split a PDF at pages containing a specific text string

⚡ Optimize Tools

Tool	Description
`compress_pdf`	Compress a PDF with optimization profiles for Web, Print, or Screen
`delete_blank_pages_from_pdf`	Remove blank pages from a PDF (no text, no images, or both)
`linearize_pdf`	Linearize a PDF for fast incremental loading in web browsers

📂 Organize Tools

Tool	Description
`delete_pdf_pages`	Remove specific pages from a PDF by page number or range
`extract_pages_from_pdf`	Extract selected pages from a PDF into a new file
`rotate_pdf`	Rotate all pages of a PDF (Clockwise, CounterClockwise, UpsideDown)
`rotate_pdf_page`	Rotate selected pages of a PDF independently

📊 PDF Information Tools

Tool	Description
`get_pdf_metadata`	Read full PDF metadata: title, author, page count, security info, and dates
`get_image_metadata`	Read image properties and available EXIF fields from a JPG or PNG
`repair_pdf`	Attempt to repair a corrupted or malformed PDF

🔒 Security Tools

Tool	Description
`protect_pdf`	Password-protect a PDF with configurable permissions (print, copy, edit, etc.)
`unlock_pdf`	Remove password protection from a PDF using the current password

🤖 AI Document Processing Tools

Tool	Description
`process_invoice`	Extract structured invoice data (line items, totals, dates, vendor info) from a PDF or image using AI
`process_bank_cheque`	Parse bank cheque images and extract cheque details using AI
`process_contract`	Extract key clauses and fields from contract documents using AI
`process_credit_card`	Extract credit card information from card images using AI
`process_health_card`	Extract data from health insurance card images using AI
`process_marriage_certificate`	Extract fields from marriage certificates using AI, with optional authenticity verification
`process_mortgage_document`	Extract key financial and property details from mortgage documents using AI
`process_pay_stub`	Extract earnings, deductions, and employee details from pay stub documents using AI
`process_bank_statement`	Parse bank statements for transactions, balances, and patterns using AI
`process_order`	Extract order details (items, quantities, prices, addresses) from purchase order documents using AI
`process_receipt`	Extract merchant info, line items, and totals from receipt images or PDFs using AI
`process_shipping_label`	Extract carrier, tracking number, and address data from shipping labels using AI
`process_tax_document`	Extract tax form fields and computed values from tax documents using AI
`process_universal_document`	Extract any specified fields from any document type using AI (configurable field list)

📜 ZUGFeRD / E-Invoice Tools

Tool	Description
`create_zugferd_invoice`	Create a ZUGFeRD-compliant e-invoice from XML, JSON, or CSV data — as PDF+XML or XML-only

🗂️ File Management Tools

Tool	Description
`upload_file`	Upload a local file to PDF4me cloud storage and receive a file reference for further operations
`get_document_from_pdf4me`	Register a webhook callback URL to receive documents from PDF4me

💡 Usage Examples

Convert a PDF to Word:

Code

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

Merge multiple PDFs:

Code

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

Extract invoice data using AI:

Code

Extract all invoice details from this file: invoice.pdf

Add a Swiss QR Bill to a PDF:

Code

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:

Code

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

Generate a document from a template:

Code

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

Compress an image:

Code

Compress this PNG image with maximum compression: photo.png

OCR a scanned PDF:

Code

Make this scanned PDF searchable: scanned_report.pdf

🛠️ Manual Run (without a client)

bash

uvx pdf4me-mcp

Or, if installed locally:

bash

PDF4ME_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.