Skip to content
MCP server

pdfmux

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.8.7
Listing updated
4 days ago

About pdfmux

pdfmux is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add pdfmux --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- uvx pdfmux

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pdfmux": {
      "command": "uvx",
      "args": [
        "pdfmux"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdfmux": {
      "command": "uvx",
      "args": [
        "pdfmux"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pdfmux": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pdfmux"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdfmux": {
      "command": "uvx",
      "args": [
        "pdfmux"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pdfmux": {
      "command": "uvx",
      "args": [
        "pdfmux"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Configuration

  • GEMINI_API_KEYOptional 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.

Pricing

Open source

Prices change. Check pdfmux.com before you buy.

pdfmux FAQ

Is pdfmux free?

Yes. pdfmux is open source, so you can use and self-host it for free.

How do I add pdfmux to Claude Code?

Run this command in your terminal: claude mcp add pdfmux --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- uvx pdfmux

What are the best alternatives to pdfmux?

The closest alternatives to pdfmux are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to pdfmux

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media