duebuddy-mcp
MCP server that reads incoming supplier invoices and returns structured data plus a file ready for accounting. Works with Claude Desktop, Cursor, Cline and any MCP client.
Install
pip install duebuddy-mcp
Run
DUEBUDDY_API_KEY=your-key duebuddy-mcp
Transport is stdio. Get an API key in the DueBuddy cabinet; 5 invoices are free.
What it reads
- PDF with embedded XML (ZUGFeRD, Factur-X), plain PDF, phone photos, scans
- E-invoices: XRechnung, FatturaPA, Peppol BIS, KSeF, UBL, ZATCA, 1C/УПД/ЭСФ
- QR bills
Country profiles: de, fr, it, pl, ru, kz, by, us, ae, sa, ua, ge.
Tools
| Tool | What it does | Cost |
|---|---|---|
parse_invoice |
Reads one invoice, returns a job_id |
XML and QR free, scans 0.07 EUR per page |
get_result |
Returns status, extracted fields and export links | free, read-only |
get_balance |
Remaining prepaid pages for the key | free, read-only |
topup_link |
Top-up page URL and minimum amount | free, builds a link only |
Plus a prompt invoice_to_accounting — a step-by-step plan for a batch: check balance, parse,
poll, validate totals, report.
Typical flow: parse_invoice → poll get_result → use the fields or the export file
(DATEV EXTF category 21, CSV, Excel, JSON).
What it does not do
It does not issue invoices, does not take payments and does not post entries into 1C or DATEV. It returns a file that those systems import.
Configuration
| Variable | Default | Meaning |
|---|---|---|
DUEBUDDY_API_KEY |
– | API key, so it need not be passed on every call |
DUEBUDDY_BASE_URL |
https://duebuddy.work |
API endpoint |
DUEBUDDY_TIMEOUT |
90 |
HTTP timeout in seconds |
Docker
docker build -t duebuddy-mcp .
docker run -i --rm -e DUEBUDDY_API_KEY=your-key duebuddy-mcp
License
MIT
Metadata
Release files for duebuddy-mcp 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| duebuddy_mcp-1.1.0.tar.gz | 7.3 kB | Without provenance | Details for duebuddy_mcp-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| duebuddy_mcp-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for duebuddy_mcp-1.1.0-py3-none-any.whl |
Total release size: 15.6 kB
Release files / duebuddy_mcp-1.1.0.tar.gz
| Download URL | duebuddy_mcp-1.1.0.tar.gz |
|---|---|
| Size | 7.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
82fa03d374c90c5bc42b5a08c981633054260e6e8f4ee2c62edf4305ed384386
|
|
BLAKE2b-256 checksum How to use checksums |
e5eeb46bf9d9f5c28d282be1c01c631455b60e65b989e13f3bcb240660f5d9e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / duebuddy_mcp-1.1.0-py3-none-any.whl
| Download URL | duebuddy_mcp-1.1.0-py3-none-any.whl |
|---|---|
| Size | 8.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e99159eb1ab32d7463e14d616d0118fb6af40c3cb9da4a89bea831d9c5a910fc
|
|
BLAKE2b-256 checksum How to use checksums |
60a4070dd8e0314f6138f4fe8073c089c9bbe7eff06491def952a0a3f92e4961
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Security for duebuddy-mcp 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.