Skip to main content

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)

Source distribution for duebuddy-mcp 1.1.0
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)

Table of built distributions (wheels) for duebuddy-mcp 1.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page