mcpbeat Sign in

pdfmux MCP Server

local only

pdfmux runs on your own machine — the client starts it, so there is no endpoint to ping. 598 installs a week from pypi. Last commit 12 Sep 2026.

PDF-to-Markdown extraction that audits its own output and flags any extractor's silent drops.

Installs per day peak 298 · avg 126 · -14% w/w
a month agotoday
598
Installs / week
pypi · pdfmux
82
Stars
4 open issues
12 Sep 2026
Last commit
0 releases in 90 days
MIT
License
Python

What the code does

We read the source, 19 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] .claude/worktrees/nifty-colden-3d35cb/integrations/llama-index-readers-pdfmux/llama_index/readers/pdfmux/__init__.py:1, [пакет] .claude/worktrees/nifty-colden-3d35cb/integrations/llama-index-readers-pdfmux/llama_index/readers/pdfmux/base.py:1, [пакет] .claude/worktrees/nifty-colden-3d35cb/npm-wrapper/index.js:1 и ещё 60
этот файл ставится пользователю, но в репозитории его нет
      const version = execSync(`${cmd} --version 2>&1`, { encoding: "utf8" });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add pdfmux -- uvx pdfmux
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pdfmux": {
      "args": [
        "pdfmux"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.pdfmux]
command = "uvx"
args = ["pdfmux"]
.cursor/mcp.json
{
  "mcpServers": {
    "pdfmux": {
      "args": [
        "pdfmux"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "pdfmux": {
      "args": [
        "pdfmux"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: GEMINI_API_KEY (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.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to pdfmux

same job, measured the same way
Urlsnap MCP
by urlsnap

Screenshot, PDF, and markdown extraction from any URL via Claude Desktop and Claude Code.

36 installs/wk local only
Brainiall Documents
by brainiall

High-fidelity PDF to structured Markdown conversion and document field extraction.

3 tools answering
Rendex: Rendering API for Images, PDFs & Content Extraction
by copperline-labs

Render HTML, Markdown, or URLs to images, PDF, or branded artifacts; extract and watch pages.

54 installs/wk 13 tools answering
MarkGrab
by arknill

Universal web content extraction — any URL to LLM-ready markdown. HTML, YouTube, PDF, DOCX.

104 installs/wk local only
PDF Text, Table and OCR Extractor
by brenton-keller

PDF URLs to per-page text, tables as rows, Markdown, metadata and OCR for scanned pages.

answering
PDF Extractor: Bulk PDF to Text, Tables & Markdown from a CSV
by nero-engine

Extract text, tables and metadata from every PDF linked in a dataset, CSV or Google Sheet.

answering
P
doc.page PDF Extraction
by doc

Extract PDFs to Markdown, RAG chunks and cited tables; publish tracked Doc Links with read stats.

7 tools answering
MCP Document Converter
by xt765

Convert PDF, DOCX, HTML, Markdown, and Text for AI assistant context injection.

98 installs/wk local only

pdfmux — questions

Answers built from our own checks of this server.

Why is there no uptime for pdfmux?
pdfmux runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package pdfmux was installed 598 times last week.
How do I connect pdfmux?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls pdfmux straight from pypi; nothing to host, nothing to sign up for.
How many people use pdfmux?
The pypi package pdfmux was installed 598 times in the last week. Week over week that is -14%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is pdfmux open source?
Yes — it is published under the MIT licence, written in Python, 82 stars on GitHub and 4 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.