MCP PDF Forms

MCP PDF Forms provides local PDF discovery, form-field inspection, page rendering and text extraction through a Python MCP server.

Local serverstdioPythonMIT

What is the MCP PDF Forms MCP Server?

MCP PDF Forms provides local PDF discovery, form-field inspection, page rendering and text extraction through a Python MCP server.

Inspect a PDF before filling it

The server uses PyMuPDF to find PDFs, extract form-widget information, highlight a selected field and render pages. It also implements text extraction and pattern search. These tools help an assistant inspect the actual document rather than guess field names from its appearance.

Launch with the intended directories

The Python package defines an mcp-pdf-forms console entry point. Its documented launch takes one or more directories to scan. Configure those paths for the documents you intend to inspect, then connect over stdio. The package metadata requires Python 3.11 or later.

Compare fields with the rendered page

Start with a test PDF containing known form widgets. Extract their names and positions, highlight one and inspect the rendered image. A flattened or scanned page may have no interactive form fields even when it visually resembles a form. Text extraction is different from OCR and should be checked against the page when the document contains images or unusual encoding.

Project documentation

Repository and setup guide

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_pdfsList PDFs in the configured paths.
extract_form_fieldsInspect interactive PDF form widgets.
highlight_form_fieldRender a PDF with a selected field highlighted.
render_pdf_pageRender a selected PDF page.
extract_textExtract text from a PDF or page range.
search_textFind text matches in a PDF.

How to install the MCP PDF Forms MCP Server

{
  "mcpServers": {
    "pdf-forms": {
      "command": "mcp-pdf-forms",
      "args": [
        "/ABSOLUTE_PATH/test-pdfs"
      ]
    }
  }
}

Configuration

Python 3.11 or later, the mcp_pdf_forms package and access to the selected PDF directories.

Frequently asked questions

No. A scanned or flattened form may have no interactive widgets. Inspect extracted fields and the rendered page together.