Markitdown vs Pdf4vllm

A side-by-side look at the Markitdown and Pdf4vllm MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

Markitdown logoMarkitdownFile Systems · Local subprocess (stdio)MCP tool access to MarkItDown -- a library that converts many file formats (local or remote) to Markdown for LLM consumption.67GreatAuth: no auth requiredPdf4vllm logoPdf4vllmFile Systems · Local subprocess (stdio)PDF reader for vision LLMs. Auto-detects text corruption and switches to image mode.45FairAuth: not declared

Verdict: choose Markitdown for file systems work as a local process; choose Pdf4vllm for file systems as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

Markitdown logoChoose Markitdown when

  • You need dedicated capabilities in the File Systems domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: No auth required.
  • You want tools like convert_to_markdown.
Explore Markitdown

Pdf4vllm logoChoose Pdf4vllm when

  • You need dedicated capabilities in the File Systems domain.
  • You prefer a local stdio subprocess transport.
  • You want tools like list_pdfs, read_pdf, grep_pdf.
Explore Pdf4vllm

Feature & specification comparison

Rows where the two servers differ are marked.

SpecMarkitdown logoMarkitdownPdf4vllm logoPdf4vllm
CategoryFile SystemsFile Systems
Quality signal67/100 · Great45/100 · Fair
Install commandConfirmedConfirmed
TransportLocal subprocess (stdio)Local subprocess (stdio)
AuthNo auth requiredNot declared
PricingFreeNot declared
Required env varsNone listedNone listed
Verified ownerCommunity listingCommunity listing
GitHub stars191,2450
Directory activity 6 views 0 installs 0 upvotes 0 views 0 installs 0 upvotes
Tools13

Tools & capabilities

Markitdown tools 1

  • convert_to_markdownConvert a resource described by an http:, https:, file: or data: URI to markdown

Pdf4vllm tools 3

  • list_pdfsFind PDF files with glob filtering (`name_pattern`)
  • read_pdfExtract PDF content as ordered blocks
  • grep_pdfSearch text in PDFs using pdfgrep (requires `pdfgrep` installed)

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

Markitdown

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "microsoft-markitdown": {
      "command": "uvx",
      "args": [
        "markitdown-ocr"
      ]
    }
  }
}

Pdf4vllm

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "pdf4vllm": {
      "command": "uvx",
      "args": [
        "pdf4vllm-mcp"
      ]
    }
  }
}

Frequently asked questions

Markitdown is categorized under File Systems and uses a local stdio subprocess. Pdf4vllm belongs to File Systems and uses a local stdio subprocess. Pick Markitdown for file systems work and Pdf4vllm for file systems.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.

Markitdown is listed as free. Auth: no auth required. Pdf4vllm has no declared pricing — check the project's own site. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add microsoft-markitdown and pdf4vllm as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, Markitdown has a quality signal of 67/100 (Great) with 6 views, 0 installs and 191,245 GitHub stars. Pdf4vllm has 45/100 (Fair) with 0 views, 0 installs and 0 GitHub stars.