pdfvera — Claude Code MCP server for PDFs and setup
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.
MIT updated 2026-11-10
claude mcp add pdfvera -e PDFVERA_API_KEY=<PDFVERA_API_KEY> -- npx -y pdfvera-mcpWhat pdfvera 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.
What it helps with
- 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 for the agent
- Convert
Rechnung.pdfinto an XRechnung. - Check the invoice PDFs in
Rechnungenwithout creating output files. - Convert
extrato.pdfto OFX for Domínio.
How to install pdfvera
Platform CLI
claude mcp add pdfvera -e PDFVERA_API_KEY=<PDFVERA_API_KEY> -- npx -y pdfvera-mcpReplace <…> with your own values
Platform CLI
codex mcp add pdfvera --env PDFVERA_API_KEY=<PDFVERA_API_KEY> -- npx -y pdfvera-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"pdfvera": {
"command": "npx",
"args": [
"-y",
"pdfvera-mcp"
],
"env": {
"PDFVERA_API_KEY": "<PDFVERA_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"pdfvera": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pdfvera-mcp"
],
"env": {
"PDFVERA_API_KEY": "<PDFVERA_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PDFVERA_API_KEY=<PDFVERA_API_KEY> pdfvera npx -y pdfvera-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pdfvera
How do I install pdfvera in Claude Code?
Add it with claude mcp add pdfvera -e PDFVERA_API_KEY=<PDFVERA_API_KEY> -- npx -y pdfvera-mcp. Replace <PDFVERA_API_KEY> with the key from a pdfvera account.
What does pdfvera do?
It turns German invoice PDFs into XRechnung and ZUGFeRD files, and Brazilian bank statements into OFX, CSV, or Excel. It can report missing invoice fields and produce a validation report.
What does pdfvera need to run?
It requires a pdfvera plan, the PDFVERA_API_KEY value, and Node.js 18 or newer. Processing a bank statement that pdfvera's rules cannot read uses the Anthropic API.