pdffr MCP Server

by amersarhan Your server? Claim it

local only

pdffr runs on your own machine — the client starts it, so there is no endpoint to ping. 7 installs a week from npm. Last commit 3 Sep 2026.

Local, private PDF to Markdown for agents: geometry-first parsing, OCR only where needed.

Installs per day peak 17 · avg 7 · -3% w/w

a month agotoday

Installs / week

npm · pdffr-mcp

Stars

0 open issues

3 Sep 2026

Last commit

2 releases in 90 days

MIT

License

TypeScript

What the code does

We read the source, 5 d ago · rules 995398eba69f

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.

Runs an external command python/langchain-pdffr/src/pdffr/__init__.py:87

        proc = subprocess.run(args, capture_output=True, text=True, timeout=timeout, check=False)

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.

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.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add pdffr-mcp -- npx -y pdffr-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.pdffr-mcp]
command = "npx"
args = ["-y", "pdffr-mcp"]

.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "pdffr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pdffr-mcp"
      ]
    }
  }
}

Alternatives to pdffr

same job, measured the same way

Caelune

by ellismorrow

Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.

local only

OmniClip RAG

by ellismorrow

Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.

local only

OmniClip RAG

by msjsc001

Read-only local-first MCP server for private Markdown, PDF, and Tika-backed search on Windows.

local only

Shelfmark

by dankaro-projects

Local, privacy-first document catalogue for AI agents: metadata-only discovery, no cloud, no RAG.

324 installs/wk local only

Context

by neuledge

Local-first documentation for AI agents. Offline, instant, private doc retrieval.

1 084 installs/wk local only

docling.rs

by docling-project

Documents to Markdown for agents: PDF layout, tables and OCR, Office, HTML, scans. docling in Rust.

4 281 installs/wk local only

Parsedoc

by custom-digital-services

Agent-native document parsing: PDF, scans and FR/EU invoices to structured JSON or Markdown.

answering

Web Tools for AI Agents

by projectworks007

Web tools for AI agents: URL to clean Markdown, site crawl, screenshots, PDF/Office to text, OCR.

answering

pdffr — questions

Answers built from our own checks of this server.

Why is there no uptime for pdffr?

pdffr 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 npm package pdffr-mcp was installed 7 times last week.

How do I connect pdffr?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls pdffr-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use pdffr?

The npm package pdffr-mcp was installed 7 times in the last week. Week over week that is -3%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is pdffr open source?

Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.