Pdfmux MCP Server

That handles digital PDFs. **For any real-world batch, install `pdfmux[ocr]` too** — almost every directory of PDFs has at least one scan, and

Local serverstdioPython

What is the Pdfmux MCP server?

Most file and storage access work still happens through a UI a human drives. Pdfmux MCP server moves it into the conversation instead. That handles digital PDFs. For any real-world batch, install pdfmux[ocr] too — almost every directory of PDFs has at least one scan, and without OCR those pages return empty text:.

The tools it exposes

The server publishes 2 tools. What each one is for:

  • LangChain — loader = PDFMuxLoader("report.pdf", quality="standard") docs = loader.load() # -> list[Document] with confidence metadata
  • LlamaIndex — The LlamaIndex tool exposed by this server

Getting it running

Installation goes through your MCP client rather than a global install: point it at pdfmux-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: GEMINI_API_KEY, ANTHROPIC_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Pdfmux's toolset — LangChain, LlamaIndex — is a fair guide to whether it matches your workflow. It is maintained by nameetp; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Pdfmux's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
LangChainloader = PDFMuxLoader("report.pdf", quality="standard") docs = loader.load() # -> list[Document] with confidence metadata
LlamaIndexThe LlamaIndex tool exposed by this server.

How to install the Pdfmux MCP server

{
  "mcpServers": {
    "pdfmux": {
      "command": "npx",
      "args": ["-y", "pdfmux-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
GEMINI_API_KEYCredential the server authenticates with.Yes
ANTHROPIC_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Pdfmux to LangChain.
  • Use Pdfmux to LlamaIndex.

Frequently asked questions

It connects Pdfmux to MCP-compatible AI assistants such as Claude and Cursor, exposing 2 tools (LangChain, LlamaIndex) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Pdfmux directly.