# pdfvera

The pdfvera MCP server for Claude Code converts German invoices into e-invoices and Brazilian bank statements into OFX, CSV, or Excel. It can also check PDFs and ask for missing invoice details.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: pdfvera
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pdfvera/pdfvera-mcp
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pdfvera

## What it does

The server sends a selected PDF to the pdfvera API and saves output files beside the original. For German invoices, it creates XRechnung in UBL or CII, ZUGFeRD, and a report based on KoSIT validation rules. When required invoice details are missing, the assistant asks for them. Use `check_only` to inspect a PDF without writing output files.

For Brazilian bank statements, it creates OFX, CSV, and Excel files. Output is written only when transaction totals match the balances shown on the statement. Password-protected PDFs are supported. A pdfvera plan and the `PDFVERA_API_KEY` are required; the server also needs Node.js 18 or newer. Each conversion uses monthly quota, while processing the same PDF again during that month does not use another conversion.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PDFVERA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add pdfvera -e PDFVERA_API_KEY=<PDFVERA_API_KEY> -- npx -y pdfvera-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pdfvera --env PDFVERA_API_KEY=<PDFVERA_API_KEY> -- npx -y pdfvera-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pdfvera": {
            "command": "npx",
            "args": [
                "-y",
                "pdfvera-mcp"
            ],
            "env": {
                "PDFVERA_API_KEY": "<PDFVERA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pdfvera": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pdfvera-mcp"
            ],
            "env": {
                "PDFVERA_API_KEY": "<PDFVERA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PDFVERA_API_KEY=<PDFVERA_API_KEY> pdfvera npx -y pdfvera-mcp
```
Replace <…> with your own values

## When to use it
- turn a German invoice PDF into XRechnung
- create ZUGFeRD output and an invoice check report
- export a Brazilian bank statement as OFX
- check PDFs without using monthly conversion quota

## Example prompts
- Convert `Rechnung.pdf` into an XRechnung.
- Check the invoice PDFs in `Rechnungen` without creating output files.
- Convert `extrato.pdf` to OFX for Domínio.

## Similar
- [scribo](https://affpapa.org/en/nevibecode/mcp/luca-kwf0-scribo.md) — MCP server · 117 installs
- [invowerk](https://affpapa.org/en/nevibecode/mcp/invowerk.md) — MCP server
- [import-transactions](https://affpapa.org/en/nevibecode/skills/import-transactions.md) — skill · 532 installs
- [AI Answer Copier](https://affpapa.org/en/nevibecode/mcp/ai-answer-copier.md) — MCP server · 3292 installs
- [document-converter-suite](https://affpapa.org/en/nevibecode/skills/document-converter-suite.md) — skill · 495 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
