# pdf-to-einvoice

> pdf-to-einvoice is an open-source MCP server for files and documents. Converts invoice PDFs to EN 16931 e-invoices (ZUGFeRD, Factur-X, XRechnung) locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web
- **Website:** https://pdf-to-einvoice.app
- **Repository:** https://github.com/smart-byte/pdf-to-einvoice
- **MCP Registry name:** io.github.smart-byte/pdf-to-einvoice
- **Categories:** files and documents, finance and payments
- **Listing updated:** 2026-11-14

## About

The original PDF layout stays as it is. The tool attaches the invoice data as factur-x.xml and turns the file into PDF/A-3, so people still read the familiar invoice while software reads the XML. It lists missing required fields, sums that do not add up, and numbers, names, addresses and dates that do not appear on the PDF before anything is created.

As an MCP server it runs over stdio on your own machine, beside a TypeScript library, a command line tool and a browser app. Nothing is uploaded by the tool itself, though an AI assistant that reads the invoice sends its content to wherever that assistant's model runs. It can also produce XRechnung for public bodies from invoice data, as plain XML or inside the PDF.

The README covers domestic invoices with VAT, several rates, small businesses, reverse charge, intra-community supplies, exports, credit notes and corrections, and says CI checks results with veraPDF and the official rule sets. The project warns its own plausibility check is not a complete validation against official rule sets. It is MIT-licensed.

## Features

- **Layout-preserving conversion:** Adds XML data without redrawing the PDF pages.
- **Pre-flight checks:** Reports missing fields, wrong sums and values absent from the PDF.
- **XRechnung output:** Creates XRechnung as plain XML or inside the PDF.
- **Local processing:** Library, CLI and MCP server run on your machine.
- **Browser app:** Drop a PDF and review marked values before download.
- **Several invoice types:** Handles credit notes, reverse charge, exports and more.

## Good for

- Make existing invoice PDFs compliant with German or French e-invoicing
- Let an assistant convert invoices without a cloud converter
- Prepare XRechnung files for public-sector buyers
- Check invoice totals before sending

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdf-to-einvoice -- npx -y pdf-to-einvoice
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pdf-to-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-einvoice"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-to-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-einvoice"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pdf-to-einvoice": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-einvoice"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-to-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-einvoice"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-to-einvoice": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-einvoice"
      ]
    }
  }
}
```

## FAQ

### Is my invoice uploaded?

The tool does not upload it, but an AI assistant reading the invoice sends content to its own model.

### What formats does it write?

ZUGFeRD / Factur-X (EN 16931 profile) and XRechnung.

### Does it fully validate against official rules?

No; it has its own plausibility check, not a complete check against the official rule sets.

### What licence is it under?

MIT.

### Is pdf-to-einvoice free?

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

### How do I add pdf-to-einvoice to Claude Code?

Run this command in your terminal: claude mcp add pdf-to-einvoice -- npx -y pdf-to-einvoice

### What are the best alternatives to pdf-to-einvoice?

The closest alternatives to pdf-to-einvoice are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, ASTra and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/pdf-to-einvoice
