
pdfmux
Handles PDF extraction through five rule-based backends (PyMuPDF, OpenDataLoader, RapidOCR, Docling, Marker) plus optional LLM fallback (Gemini, Claude, GPT-4o, Ollama). The router audits each page's output with confidence scoring, then re-extracts failures with a stronger backend. Exposes convert, chunk, batch_extract, and stream operations through stdio transport. You'd reach for this when RAG pipelines need clean markdown from mixed PDF batches (digital text, scans, tables) without manual per-document tuning. The CLI includes watch mode for folder monitoring, diff for comparing extractions, and estimate for cost prediction before runs. Three quality presets (economy, balanced, premium) with budget caps keep LLM costs predictable.
- GitHub stars
- 86
- tools
- 6
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Jul 27, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
convert_pdf
No parameter schema in public metadata yet.
analyze_pdf
No parameter schema in public metadata yet.
extract_structured
No parameter schema in public metadata yet.
extract_streaming
No parameter schema in public metadata yet.
get_pdf_metadata
No parameter schema in public metadata yet.
batch_convert
No parameter schema in public metadata yet.
Sponsors
Configuration
GEMINI_API_KEYsecretOptional Google AI API key. Enables the paid Gemini Flash fallback for pages where all local backends report low confidence. pdfmux runs 100% locally without this.
Readme
pdfmux
Self-healing PDF extraction that flags the pages it can't read instead of dropping them — and now certifies any extractor's output for silent drops. Open-source LlamaParse alternative for RAG pipelines, MCP server for Claude Desktop, LangChain + LlamaIndex loaders.
pdfmux extracts PDFs and checks its own work — and now certifies any extractor's, telling you which pages it silently dropped. Free, MIT. Patent-pending method.
pip install pdfmux.
Two jobs, one tool:
Details
- Repository
- github.com/nameetp/pdfmux
- Website
- pdfmux.com
- Category
- Documents & Knowledge
- Package
pdfmux- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active