nameetp avatar

pdfmux

nameetp/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 tools

Public 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_KEYsecret

Optional 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

CI PyPI Python 3.11+ License: MIT Downloads

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:


View the full README on GitHub

Details

Repository
github.com/nameetp/pdfmux
Website
pdfmux.com
Category
Documents & Knowledge
Package
pdfmux
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Documents & Knowledge MCP servers

View all
1oscardvs avatarZoteusoscardvs/zoteusZotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.65stars
2eclipse-cj avatarPaper Distill MCPeclipse-cj/paper-distill-mcpAcademic paper search across 11 sources with AI curation, ranked push, Zotero and Obsidian support.64stars
3msjsc001 avatarOmniClip RAGmsjsc001/omniclip-ragRead-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.37stars
4semiotronika avatarNouzsemiotronika/nouz-mcpSemantic knowledge engine for Obsidian with auto-classification and DAG hierarchy24stars
5xt765 avatarMCP Document Readerxt765/mcp_documents_readerAn MCP enabled multi-format document reader supporting DOCX, PDF, TXT, and Excel files21stars
6the-40-thieves avatarReliquary-TCthe-40-thieves/reliquary-tcGoverned Obsidian vault access: hybrid retrieval, Markdown-native memory, HITL confirmations.13stars