pdf4me-mcp 0.1.3

PDF4me MCP Server for PDF and document automation workflows

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

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:

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.