Skip to main content
Glama
pdf4me
by pdf4me

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


Related MCP server: MCP PDF

⚙️ 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.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    Provides PDF.co API functionality through the Model Context Protocol, enabling AI assistants to perform various PDF processing tasks like conversion, editing, searching, and security operations.
    Last updated
    38
    9
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Enables AI-powered extraction and analysis of PDF documents with 40+ specialized tools for text, tables, images, layout analysis, security assessment, and document intelligence. Supports both text-based and scanned PDFs with OCR capabilities.
    Last updated
    9
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables PDF processing and analysis including text extraction, metadata retrieval, search, page manipulation, splitting/merging, conversion to images, and form handling.
    Last updated
    10
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pdf4me/pdf4me-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server