# benethos-lexware-office-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/benethos-hub/lexware-office-mcp  
**GitHub Stars:** 2  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/benethos-lexware-office-mcp

## Description
Unofficial MCP server for the Lexware Office accounting API — runs over stdio or HTTP.

## Tools
Capabilities this server exposes over MCP:

- **get_profile** — Company profile and connection check
- **search_contacts** — Find customers and vendors by name, email, number or role
- **get_contact** — One contact with addresses, roles and version
- **search_articles** — List articles, filtered by number, barcode or kind. The API offers no search by title
- **get_article** — One article with its price block and version
- **search_vouchers** — The central query — filter the voucher list by type, status, contact, document number, date range and what is still open
- **get_sales_document** — Read an invoice, quotation, credit note, order confirmation, delivery note, dunning or down payment invoice in full
- **get_voucher** — Read a bookkeeping voucher, by id or by its document number
- **get_payments** — Payment status and open amount of a voucher
- **get_recurring_templates** — Templates that issue invoices on a schedule, one or a page of them
- **get_master_data** — Countries, payment conditions, posting categories and print layouts, with a search to narrow them
- **download_document** — Save the rendered PDF or XML of a sales document
- **download_file** — Save a stored file, such as an uploaded receipt
- **read_download** — Put a downloaded file into the answer, for clients that cannot follow a resource link
- **get_deeplink** — Build a permalink to a sales document, contact or voucher in the web app, without an API call
- **create_contact** — Create a customer or vendor
- **update_contact** — Change one, without touching what you did not name
- **create_article** — Add an article to the catalogue
- **update_article** — Change one, without touching what you did not name
- **create_voucher** — Record a bookkeeping voucher
- **update_voucher** — Change one that is already recorded, or book a receipt that `upload_file` left unchecked
- **create_sales_document** — Create an invoice, quotation, credit note, order confirmation, delivery note or dunning — a draft unless you ask for it to be issued, which the assistant may only do on your explicit instruction
- **upload_file** — Upload a receipt, which also creates its voucher
- **attach_file_to_voucher** — Hang a file on a voucher that already exists
- **delete_article** — Remove an article. The API cannot bring it back. Takes `confirm: true`, and sends nothing without it

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "benethos-lexware-office-mcp": {
    "command": "uvx",
    "args": ["benethos-lexware-office-mcp"]
  }
}
```

## Documentation

## What benethos-lexware-office-mcp MCP server does

The benethos-lexware-office-mcp MCP server gives an MCP client access to a Lexware Office account through the documented public REST API. It covers common accounting data and documents: company profile information, contacts, articles, vouchers, sales documents, payment status, recurring invoice templates, master data, and stored files.

Read operations include searching for customers, vendors, articles, and vouchers; retrieving individual records; checking unpaid amounts; and obtaining links to records in the Lexware Office web application. Documents can be saved as rendered PDF or XML files, while uploaded receipts and other stored files can be downloaded and returned to clients that cannot follow resource links.

Write operations are also available when explicitly enabled. These include creating or updating contacts and articles, recording or changing vouchers, creating sales documents, uploading receipts, attaching files to vouchers, and deleting articles. Article deletion requires an explicit confirmation value, and the API cannot restore a deleted article.

## How it works

The benethos-lexware-office-mcp MCP server supports stdio for clients that start the process locally and streamable HTTP for remote access. HTTP access uses a bearer token. In both modes, the MCP client sees only the tools permitted by the server’s policy configuration.

A single API client communicates with Lexware Office over HTTPS, with rate limiting applied to requests. The server uses an API key generated for the Lexware Office account. The key is kept in the environment configuration, is not returned by tools, and is redacted from error messages. The project is unofficial and is not affiliated with Lexware or Haufe-Lexware.

## Setup and configuration

Installation is documented through PyPI, a Claude Desktop extension, and a published container image. The repository also provides Compose-based container operation. Running the setup process writes the environment configuration and the tool policy file; setup can be started with the `setup` command.

A policy file must name each permitted tool. A fresh installation exposes no tools until that policy exists, so read-only operation can be selected by enabling only search, read, and download capabilities. Individual write tools can be enabled separately rather than through a single broad permission level.

The API key should be placed in the environment file rather than a client configuration file. HTTP deployments additionally require the bearer-token arrangement described by the project’s configuration documentation.

## Tools and capabilities

The available tools support these workflows:

- Check the connected company with `get_profile`.
- Search and inspect contacts, articles, vouchers, and sales documents.
- Check voucher payments and outstanding amounts.
- Create or modify contacts, articles, vouchers, and sales documents.
- Upload receipts and attach files to existing vouchers.
- Download sales documents as PDF or XML, or retrieve stored files.
- Generate web-app links for contacts, vouchers, and sales documents.
- Remove an article only when `confirm: true` is supplied.

## Limitations and notes

Lexware’s article API does not support searching by title. Bookkeeping vouchers cannot be deleted through this API, and finalized sales documents are real accounting records that cannot be withdrawn through the server. The API may change, apply rate limits, or block requests.

Data may be incomplete or outdated. The project is not accounting, tax, or legal advice, and its documentation warns against relying on it for filings, audits, or bookkeeping obligations. Commercial users should review Lexware’s API terms and their own retention and documentation requirements.

_Full upstream README: https://allmcps.com/mcp/benethos-lexware-office-mcp/readme_