pdf-toolbox-mcp MCP Server

中文文档 | Local-first PDF processing for AI agents.

Local serverstdio

What is the pdf-toolbox-mcp Server?

pdf-toolbox-mcp is an MCP project maintained in the twoer/pdf-toolbox-mcp repository. The maintainer describes its purpose as “中文文档 | Local-first PDF processing for AI agents”. Read the project documentation for the complete scope.

Installation

The documented pypi package is pdf-toolbox-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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
Singlefile outputs are written to a same-directory temporary file and atomically replaced only after the operation succeeds.
pdf_infoPages, encryption status, metadata — always call first
is_searchableSmart routing: text density check → recommends extract_text or ocr_pdf
extract_textLayout-aware text, exact page ranges 1-3,5, per-page mode
ocr_pdfOCR write-back: scan → searchable PDF (deskew, skip/redo, lang fallback)
batch_ocrWhole-directory OCR with per-file results, retries, timeouts
render_pagesPNG per page, return_images=true streams image blocks to the vision model
extract_imagesPull embedded images (inventory or PNG files)
extract_attachmentsPull embedded attachment files
list_fontsFont audit — non-embedded fonts risk missing glyphs on other machines
unlock_pdfDecrypt with user password, output a clean decrypted file; password sent via stdin
protect_pdfAES-256 + granular permissions (print/extract/modify/…)
split_pdfBy ranges or every N pages
merge_pdfsOrdered merge
rotate_pages90/180/270 on selected pages
check_repairStructural check; repair=true rebuilds damaged files
linearizeWeb-optimized progressive-loading output
sanitizePublishing hygiene: strip JS/OpenAction/metadata/attachments
redactTrue redaction: affected pages rasterized + opaque boxes — redacted text physically unrecoverable, other pages keep their text layer (rasterize_all=true for…
redact_textRedact by content: locate every occurrence of the given keywords and black them out — no manual coordinates needed
locate_textFind where text occurs: page + bounding boxes (PDF points, top-left origin) — the foundation for redaction & highlighting
fill_formFill AcroForm fields (missing fields reported)
edit_metadataSet/clear Title/Author/… (docinfo + XMP)
compress_pdfCompress, optionally down a quality ladder until hitting target_mb
dependency_statusProbe system tools + install commands
doctorOne-shot onboarding check: imports, dependency probe, README paths

How to install the pdf-toolbox-mcp Server

{
  "mcpServers": {
    "pdf-toolbox": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-toolbox-mcp",
        "pdftoolbox"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.