lexware_create_article
Create a new article.
LABSCO SUMMARY
Draft or final is decided when the document is created, and that one detail shapes the whole workflow.
lexware_create_invoice takes finalize=true to come out with status open; the API does not support finalizing an existing draft, so a draft made without it stays one. Documents connect through the pursue tools rather than through edits — a quotation leads to an order confirmation, that or the quotation to a delivery note, an invoice to a credit note or a dunning — each by precedingSalesVoucherId. Webhook verification is exacting for a reason: it wants the raw HTTP body bytes as received, because the signature covers the compact JSON as transmitted, whitespace and key order included.
What it is
A Lexware Office client of 66 tools across 20 resource domains, covering the sales-voucher chain, bookkeeping vouchers, contacts and articles, file upload and webhook subscriptions. Five narrower entry points ship alongside the full one, so a client with a tool limit can load only the domain it needs.
What you get
- The sales-voucher chain, each document created and read on its own: lexware_create_invoice, lexware_create_credit_note, lexware_create_quotation, lexware_create_order_confirmation and lexware_create_delivery_note, with matching lexware_get_invoice, lexware_get_credit_note, lexware_get_quotation, lexware_get_order_confirmation, lexware_get_delivery_note and lexware_get_down_payment_invoice.
- Follow-up creation that keeps the paper trail: lexware_pursue_invoice, lexware_pursue_credit_note, lexware_pursue_order_confirmation, lexware_pursue_delivery_note and lexware_pursue_dunning, each taking the precedingSalesVoucherId of the document it follows.
- Files out: lexware_download_invoice_file, lexware_download_credit_note_file and lexware_download_down_payment_invoice_file default to PDF and take format="xml" for the XRechnung e-invoice; lexware_download_quotation_file, lexware_download_order_confirmation_file, lexware_download_delivery_note_file and lexware_download_dunning_file return PDF.
- Deep links straight into the Lexware web app for invoices, credit notes, quotations, order confirmations, delivery notes, down payment invoices, dunnings, contacts, vouchers, recurring templates and the bookkeeping inbox.
- Master data: lexware_list_contacts, lexware_get_contact, lexware_create_contact and lexware_update_contact; lexware_list_articles, lexware_get_article, lexware_create_article, lexware_update_article and lexware_delete_article; plus lexware_list_countries with their tax classifications, lexware_list_payment_conditions, lexware_list_posting_categories, lexware_list_print_layouts and lexware_get_profile.
- Bookkeeping: lexware_create_voucher, lexware_get_voucher, lexware_update_voucher, lexware_list_vouchers, lexware_upload_voucher_file and lexware_get_payments, with lexware_list_voucherlist searching across every voucher type at once.
- Files and recurring templates: lexware_upload_file, lexware_download_file returning base64 content, lexware_get_file_status, and lexware_list_recurring_templates with lexware_get_recurring_template.
- Webhooks: lexware_create_event_subscription, lexware_list_event_subscriptions, lexware_get_event_subscription and lexware_delete_event_subscription, with lexware_verify_webhook_signature checking the X-Lxo-Signature against the raw body.
Requirements
A Lexware Office organization and an API token from its public-API settings. The token is read from your OS keyring first and from LEXWARE_API_TOKEN second — the keyring route is the one the author documents, with prompts that keep the token out of your shell history and the process list. Install with npm and run the full server, or pick one of the narrower entry points for sales, contacts, bookkeeping, reference data or system when your client caps how many tools it will load. Creating an event subscription needs a callbackUrl Lexware can reach, and the update tools for articles, contacts and vouchers need the record's version field for optimistic locking. Unofficial and not affiliated with Lexware.
Setup effort
One command plus a key — npm install -g @lazyants/lexware-mcp-server, then supply credentials
USE CASES
01
Walking an accepted quotation through to an invoice without retyping it
Create each following document as a pursuit of the one before, so the chain stays linked in Lexware.
02
Sending an invoice to a recipient who requires XRechnung
Create it finalized rather than as a draft, then download the XML representation instead of the PDF.
03
Chasing an unpaid invoice
Check what has been paid against it, then raise the dunning as a follow-up to the invoice itself.
04
Finding a document when you only remember roughly what it was
One search runs across every voucher type rather than checking each kind separately.
05
Getting a receipt into the books
Create the bookkeeping voucher and attach the file to it, then open it in the web app if it needs a human.
06
Reacting when something changes in Lexware
Subscribe to the event, then verify the signature against the exact bytes you received.
66 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
lexware_create_contact
Create a new contact.
lexware_create_credit_note
Create a new credit note in Lexware.
lexware_create_delivery_note
Create a new delivery note in Lexware.
lexware_create_event_subscription
Create a new webhook event subscription in Lexware.
lexware_create_invoice
Create a new invoice in Lexware. Set finalize=true to immediately finalize (status "open"); omit or false to create as draft. The Lexware API does not support finalizing an existing draft — this is the only documented way to obtain a finalized invoice.
lexware_create_order_confirmation
Create a new order confirmation in Lexware.
lexware_create_quotation
Create a new quotation in Lexware.
lexware_create_voucher
Create a new bookkeeping voucher in Lexware.
lexware_deeplink_contact
Get a direct URL to view a contact in the Lexware web app.
lexware_deeplink_credit_note
Get a direct link to view/edit a credit note in the Lexware web app.
lexware_deeplink_delivery_note
Get a direct link to view/edit a delivery note in the Lexware web app.
lexware_deeplink_down_payment_invoice
Get a direct link to view/edit a down payment invoice in the Lexware web app.
lexware_deeplink_dunning
Get a direct link to view/edit a dunning in the Lexware web app.
lexware_deeplink_file
Get a direct link to the bookkeeping inbox of newly-uploaded files in the Lexware web app.
lexware_deeplink_invoice
Get a direct link to view/edit an invoice in the Lexware web app.
lexware_deeplink_order_confirmation
Get a direct link to view/edit an order confirmation in the Lexware web app.
lexware_deeplink_quotation
Get a direct link to view/edit a quotation in the Lexware web app.
lexware_deeplink_recurring_template
Get a direct link to view/edit a recurring invoice template in the Lexware web app.
lexware_deeplink_voucher
Get a direct link to view/edit a bookkeeping voucher in the Lexware web app.
lexware_delete_article
Delete an article by ID.
lexware_delete_event_subscription
Delete a webhook event subscription from Lexware.
lexware_download_credit_note_file
Download the file for a credit note. Defaults to PDF; pass format="xml" to request the XRechnung XML e-invoice when available (the API returns whatever representation it can render).
lexware_download_delivery_note_file
Download the PDF file for a delivery note.
lexware_download_down_payment_invoice_file
Download the file for a down payment invoice. Defaults to PDF; pass format="xml" to request the XRechnung XML e-invoice when available (the API returns whatever representation it can render).
lexware_download_dunning_file
Download the PDF file for a dunning.
lexware_download_file
Download a file from Lexware. Returns the file as base64-encoded content.
lexware_download_invoice_file
Download the file for an invoice. Defaults to PDF; pass format="xml" to request the XRechnung XML e-invoice when available (the API returns whatever representation it can render).
lexware_download_order_confirmation_file
Download the PDF file for an order confirmation.
lexware_download_quotation_file
Download the PDF file for a quotation.
lexware_get_article
Get a single article by ID.
lexware_get_contact
Get a single contact by ID.
lexware_get_credit_note
Retrieve a credit note by ID from Lexware.
lexware_get_delivery_note
Retrieve a delivery note by ID from Lexware.
lexware_get_down_payment_invoice
Retrieve a down payment invoice by ID from Lexware.
lexware_get_dunning
Retrieve a dunning by ID from Lexware.
lexware_get_event_subscription
Retrieve a webhook event subscription by ID from Lexware.
lexware_get_file_status
Get file metadata and processing status from Lexware.
lexware_get_invoice
Retrieve an invoice by ID from Lexware.
lexware_get_order_confirmation
Retrieve an order confirmation by ID from Lexware.
lexware_get_payments
Get payment details for a specific voucher.
lexware_get_profile
Get the organization profile information.
lexware_get_quotation
Retrieve a quotation by ID from Lexware.
lexware_get_recurring_template
Retrieve a recurring invoice template by ID from Lexware.
lexware_get_voucher
Retrieve a bookkeeping voucher by ID from Lexware.
lexware_list_articles
List all articles with optional pagination.
lexware_list_contacts
List all contacts with optional pagination and filters.
lexware_list_countries
List all available countries with their tax classifications.
lexware_list_event_subscriptions
List all webhook event subscriptions in Lexware.
lexware_list_payment_conditions
List all available payment conditions.
lexware_list_posting_categories
List all available posting categories for bookkeeping.
lexware_list_print_layouts
List available print layout templates.
lexware_list_recurring_templates
List recurring invoice templates from Lexware.
lexware_list_voucherlist
Search and filter across all voucher types in Lexware. This is the main way to find invoices, credit notes, quotations, and other voucher types.
lexware_list_vouchers
List bookkeeping vouchers from Lexware with optional filters.
lexware_pursue_credit_note
Create a new credit note as a follow-up to a preceding invoice. Maps to the documented POST /credit-notes?precedingSalesVoucherId={id}[&finalize=true] endpoint. Set finalize=true to immediately finalize the credit note; omit or false to create as draft.
lexware_pursue_delivery_note
Create a new delivery note as a follow-up to a preceding quotation or order confirmation. Maps to the documented POST /delivery-notes?precedingSalesVoucherId={id} endpoint.
lexware_pursue_dunning
Create a new dunning as a follow-up to a preceding invoice via the documented POST /dunnings?precedingSalesVoucherId={id} endpoint. Dunnings are always created in draft mode and do not need to be finalized.
lexware_pursue_invoice
Create a new invoice as a follow-up to a preceding sales voucher (quotation, order confirmation, or delivery note). Maps to the documented POST /invoices?precedingSalesVoucherId={id}[&finalize=true] endpoint. Set finalize=true to immediately finalize the new invoice (status "open"); omit or false to create as draft.
lexware_pursue_order_confirmation
Create a new order confirmation as a follow-up to a preceding quotation. Maps to the documented POST /order-confirmations?precedingSalesVoucherId={id} endpoint.
lexware_update_article
Update an existing article. The body must include the version field for optimistic locking.
lexware_update_contact
Update an existing contact. The body must include the version field for optimistic locking.
lexware_update_voucher
Update an existing bookkeeping voucher in Lexware. Requires version field for optimistic locking.
lexware_upload_file
Upload a file to Lexware.
lexware_upload_voucher_file
Upload a file attachment to a bookkeeping voucher.
lexware_verify_webhook_signature
Verify a Lexware webhook X-Lxo-Signature (RSA-SHA512, base64) against the raw request body. Pass the EXACT raw HTTP body bytes you received — do not JSON.parse/stringify round-trip, as Lexware signs the compact JSON as transmitted (whitespace and key order matter). On first call the public key is fetched once from developers.lexware.io and cached for the process lifetime; set LEXWARE_WEBHOOK_PUBLIC_KEY (PEM) to override (recommended for production where you cannot tolerate one-time TLS-substitution risk on the public-key fetch).
BEFORE YOU INSTALL
What to know first
Tools you get
66 tools when we connected. Separate binaries load subsets: lexware-mcp-sales 32, lexware-mcp-contacts 10, lexware-mcp-bookkeeping 8, lexware-mcp-reference 5 and lexware-mcp-system 12, with the Voucherlist tool in both sales and bookkeeping.
Requires
- npx on PATH
- LEXWARE_API_TOKEN in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 66 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @lazyants/lexware-mcp-serverMCP Clients
Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"lexware": {
"command": "npx",
"args": [
"-y",
"@lazyants/lexware-mcp-server"
]
}
}
}Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"lexware": {
"command": "npx",
"args": [
"-y",
"@lazyants/lexware-mcp-server"
],
"env": {
"LEXWARE_API_TOKEN": "<YOUR_LEXWARE_API_TOKEN>"
}
}
}
}
