# PdfPecker

> PdfPecker is an open-source MCP server for files and documents. Convert HTML and Markdown to PDF with no browser, plus page previews and merging. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, macOS, Windows, CLI
- **Website:** https://pdfpecker.net
- **Repository:** https://github.com/moonwalker1307/pdfpecker.python
- **MCP Registry name:** io.github.Moonwalker1307/pdfpecker
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

PdfPecker for Python is the .NET PdfPecker library compiled ahead of time into a native library inside the wheel, so converting a page does not start a browser or pull in other dependencies. The README reports about 0.7 ms for a one-page invoice on a 4-core Linux VM, against 24 ms for Chromium via Playwright.

The MCP server covers HTML and Markdown to PDF, page previews, PDF text extraction and merging, and the registry says it uses no network. The Python API also converts PDFs to images and files, and the library supports modern CSS, embedded fonts, right-to-left and complex scripts, SVG, barcodes and QR codes, PDF/A and encryption.

Wheels exist for Linux (glibc and musl), macOS and Windows on x64 and ARM64, Python 3.9 and later. The library is MIT licensed.

## Features

- **No browser needed:** Own HTML parser, CSS engine, layout and PDF writer.
- **HTML and Markdown input:** CommonMark with GitHub tables and footnotes.
- **PDF text and images:** Extract text or render pages to PNG, JPEG or WebP.
- **Merging:** Combine PDFs from bytes or paths.
- **Business document features:** Page numbers, running headers, PDF/A and encryption.
- **Broad platforms:** Linux, macOS and Windows on x64 and ARM64.

## Good for

- Generate invoices and reports from HTML templates
- Preview a rendered PDF page as an image
- Extract text from a PDF
- Merge several PDFs into one

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdfpecker -- uvx pdfpecker
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pdfpecker": {
      "command": "uvx",
      "args": [
        "pdfpecker"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pdfpecker": {
      "command": "uvx",
      "args": [
        "pdfpecker"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pdfpecker": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pdfpecker"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pdfpecker": {
      "command": "uvx",
      "args": [
        "pdfpecker"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pdfpecker": {
      "command": "uvx",
      "args": [
        "pdfpecker"
      ]
    }
  }
}
```

## FAQ

### Does it need Chromium?

No. The README says it never starts a browser.

### Which Python versions work?

Python 3.9 and later.

### What licence?

The library is MIT.

### Is it fast?

The README benchmark shows about 0.7 ms for a one-page invoice.

### Is PdfPecker free?

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

### How do I add PdfPecker to Claude Code?

Run this command in your terminal: claude mcp add pdfpecker -- uvx pdfpecker

### What are the best alternatives to PdfPecker?

The closest alternatives to PdfPecker are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pdfpecker
