Invoices
● Activework.duebuddy/invoices
Read supplier invoices (PDF, photo, XML) and return fields plus a DATEV/1C/CSV file.
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"invoices": {
"command": "uvx",
"args": [
"duebuddy-mcp",
"duebuddy-mcp"
],
"env": {
"DUEBUDDY_API_KEY": "<your DUEBUDDY_API_KEY>"
}
}
}
}claude mcp add --env DUEBUDDY_API_KEY='<your DUEBUDDY_API_KEY>' --transport stdio invoices -- uvx duebuddy-mcp duebuddy-mcpcodex mcp add invoices --env DUEBUDDY_API_KEY='<your DUEBUDDY_API_KEY>' -- uvx duebuddy-mcp duebuddy-mcpcode --add-mcp '{"name":"invoices","type":"stdio","command":"uvx","args":["duebuddy-mcp","duebuddy-mcp"],"env":{"DUEBUDDY_API_KEY":"<your DUEBUDDY_API_KEY>"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- DUEBUDDY_API_KEYsecretDueBuddy API key. Five invoices are free, no card required.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Finance
- Version
- 1.1.1
- Registry
- active
- Published
- 11/17/2026
Live check
checked Nov 20, 2026, 09:08 UTCThe endpoint answered the MCP handshake as "DueBuddy — invoice parsing and polite reminders" and listed 4 tools. Answering since Nov 18, 2026.
Context cost ≈ 1.8k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 4 tools.
Tools (4)
tool list changed Nov 19, 2026, 08:08 UTCparse_invoice3 paramsReads ONE incoming supplier invoice and returns a job id for polling. Use when: the user has a single invoice (PDF, photo, scan, XML e-invoice or QR bill) and wants supplier, invoice number, dates, amounts, VAT or line items extracted. Do not use when: the user asks to ISSUE an invoice, to send a payment, or to post entries into DATEV/1C — this tool only reads documents. For several documents call it once per document; the returned job ids can be polled independently. Side effects and cost: the document is downloaded and queued. XML and QR invoices are parsed by code and cost nothing; scans and photos cost 0.07 EUR per page, charged to the prepaid balance. Not idempotent: each call creates a new job and a new charge for scans. Parameter interactions and edge cases: the same file parsed twice returns the existing job with charged=false instead of billing twice, so retrying after a client timeout is safe — and the second call's country is ignored, the first profile wins. Per API key there is a request rate limit and a cap of 3 parses in flight; exceeding either returns 429 with Retry-After, which is a throttle, not a billing error. country changes field names and tax checks, never the price. Returns: {ok, job_id, status}. Next step: call get_result with that job_id.
Show parametersHide parameters
file_urlstringrequiredPublic https URL of exactly ONE invoice file hosted on duebuddy.work, for example https://duebuddy.work/files/invoice-218.pdf. Allowed endings: .pdf, .jpg, .jpecountrystringTwo-letter parsing profile that selects field names and tax rules: de, fr, it, pl, ru, kz, by, us, ae, sa, ua, ge. Defaults to de. Does not change the price; aapi_keystringDueBuddy API key (starts with dd_). Omit it when the server was added with an X-Api-Key header or DUEBUDDY_API_KEY is set; the call returns api_key_required whe
get_result2 paramsReturns the result of a parse job started by parse_invoice: structured fields (supplier, invoice number, dates, net/VAT/gross, currency, line items) plus export links for accounting systems. Use when: you already have a job_id and want its status or its extracted data. Do not use when: you have no job_id yet — start with parse_invoice. Do not poll in a tight loop: one call every few seconds is enough, text PDFs and XML usually finish in under a minute. Side effects and cost: none. Does not touch the prepaid balance, so repeated polling is free; a failed job stays failed. Parameter interactions and edge cases: job_id belongs to the key that created it, so a job started with one key is invisible to another. A pasted URL or a document id from another system returns 404 rather than a guess. A job that failed stays failed — polling it again will not resurrect it; start a new parse_invoice call instead. Returns: {ok, result}, where result.status is queued, processing, done or failed; on done it also carries fields and export links.
Show parametersHide parameters
job_idstringrequiredJob identifier from the parse_invoice response, for example "2507". Scoped to the API key that created it: another key gets 404. Accepts the numeric id, not a Uapi_keystringDueBuddy API key (starts with dd_). Omit it when the server was added with an X-Api-Key header or DUEBUDDY_API_KEY is set. Must be the same key that started the
get_balance1 paramShows how many scanned pages are left on the prepaid balance for this API key. Use when: before a batch of scans or photos, or when parse_invoice answered insufficient_balance and the remaining amount must be confirmed. Do not use when: the user asks about invoice content — that is get_result. Side effects and cost: none. The number comes from the same counter that blocks parsing, so it can change between two calls while a batch is running. Parameter interactions and edge cases: this is the same counter that blocks parsing, so a balance of zero makes the next parse_invoice fail with insufficient_balance and a topup_link is the only way forward. Two keys of one account see the same number, because usage is counted per account. The number can drop between two calls while a batch runs, and pages parsed on the free cabinet allowance are not part of it. Returns: {ok, balance} with remaining pages and the current plan.
Show parametersHide parameters
api_keystringDueBuddy API key (starts with dd_). Omit it when the server was added with an X-Api-Key header or DUEBUDDY_API_KEY is set; the call returns api_key_required ins
topup_link1 paramReturns the page where the prepaid balance can be topped up, plus the minimum amount. Use when: the balance is empty or too low for the documents the user wants to process. Do not use when: the balance is sufficient — check it with get_balance first. Side effects and cost: none. The call only builds a link; the payment happens in the browser and is handled by the payment provider, never by this server. Parameter interactions and edge cases: amount_eur is echoed back only; a value outside 8..5000 is rejected by parameter validation before the call runs. The returned url is a pricing page, not a payment link tied to a sum — the user chooses the amount there. Calling it repeatedly returns the same page and creates no orders. Returns: {ok, url, minimum_eur}.
Show parametersHide parameters
amount_eurnumberPlanned top-up in euro, minimum 8, maximum 5000, default 8. Informational only: it does not create an order or reserve money, it is echoed back in requested_eur
Checked by Serverdex with a plain initialize + tools/list call to duebuddy.work/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 17, 2026- Stars
- 1
- Forks
- 0
- Last push
- Nov 17, 2026
- License
- MIT
Python1caccountingai-agentdateve-invoicingfactur-xfattura-painvoice-parsingmcpmcp-servermodel-context-protocolocrpeppolxrechnungzugferd
From the README
duebuddy-mcp mcp-name: work.duebuddy/invoices MCP server that reads incoming supplier invoices and returns structured data plus a file ready for accounting. One endpoint for PDF, photos, scans, QR bills and electronic invoices. Works with Claude Desktop, Cursor, Cline, Windsurf and any MCP client that supports stdio. Hosted alternative: https://duebuddy.work/mcp (streamable HTTP), no install needed. Docs: https://duebuddy.work/mcp-docs Why this exists An accountant receives forty invoices a quarter. Half of them already contain the data in machine-readable form — ZUGFeRD, XRechnung, Factur-X, FatturaPA, Peppol, KSeF, UBL — but they arrive as invoice.pdf, so they get retyped by hand. The other half are scans and phone photos where no data exists at all. This server handles both cases and returns fields plus an import file, so the human checks instead of retyping. Quick start 1. Get an API key Sign up at https://duebuddy.work, open the cabinet, create an API key. Five invoices are free, no card required. 2. Claude Desktop ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows): 3. Cursor .cursor/mcp.json in your project: 4.…
Read the full README on GitHub →Remotes
- streamable-http
https://duebuddy.work/mcp
Alternatives to Invoices
Best Finance servers →The most-starred Finance servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| CCXT | 44,881 | Nov 2026 | Local / not checked |
| QR Rápido | 7,477 | Nov 2026 | Needs sign-in |
| Finance Toolkit | 5,522 | Nov 2026 | Needs sign-in |
| AKQuant | 2,607 | Nov 2026 | Local / not checked |
| com.stripe MCP | 2,072 | Nov 2026 | Needs sign-in |
Invoices: questions people ask
- Is Invoices a remote or a local MCP server?
- According to its entry in the official MCP registry, Invoices ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (PyPI) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
- Does Invoices need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 20, 2026. Individual tools may still ask for a key when called.
- Is Invoices still maintained?
- Active: the repository's last commit 3 days ago. Last push Nov 17, 2026, 1 GitHub stars, MIT licence. Read from GitHub on Nov 17, 2026.
- What tools does Invoices expose?
- 4 tools as listed by the server itself during the live check, including parse_invoice, get_result, get_balance, topup_link. The full list with parameters is in the Live check section above.
- How do I add Invoices to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Finance servers
Browse all Finance →Canisell
kacpergumieniuk
Can I sell this Base token? Honeypot, tax and exit-liquidity verdict. Free metadata; $0.01 via x402.
BTCPay Server MCP
ThomsenDrake
21 tools for AI agents to manage BTCPay Server: invoices, payments, stores, webhooks, Lightning
Iposignal
Waltermelon-lang
IPO deal terms, SEC filings, AI research and sentiment, plus live valuation metrics for US stocks.
JP-Verify
Hiroshi-Ichiyanagi
Verify Japanese companies: invoice T-numbers, Corporate Numbers, English names, shareholders
PayStage
base-buzz
Umbrella MCP: payment preflight, auth watch, HIP-3 trade preflight, velocity checks
PayStage Trade Preflight
base-buzz
MCP tool: evaluate HIP-3/trade.xyz orders against a local TradePolicy before trading
Add the badge to your site
Show visitors that Invoices is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/work-duebuddy-invoices?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Invoices — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/work-duebuddy-invoices?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).