Lexware

What lexware does

lexware exposes selected Lexware Office API operations through the Model Context Protocol. The listed tools focus on sales and receivables documents: credit notes, quotations, order confirmations, delivery notes, down-payment invoices, and dunnings. Depending on the document type, an agent can create or retrieve records, download generated files, pursue a document, or open a Lexware deep link.

Contact management is also included. Agents can list contacts, retrieve an individual contact, create a new contact, and update an existing one. The package also provides separate entry points for broader functional areas, including sales, contacts, bookkeeping, reference data, and system operations; the split commands are intended for installations that need a smaller tool set or a reduced MCP context.

How it works

The server communicates with an MCP client over its command-line entry point. A full installation uses the lexware-mcp-server package command, while focused deployments can invoke commands such as lexware-mcp-sales or lexware-mcp-contacts through npx. Each entry point exposes the corresponding Lexware operations to the client.

Authentication uses a Lexware Office API token. The server checks the operating system keyring first, using the lexware-mcp service and api-token account, then falls back to the LEXWARE_API_TOKEN environment variable. Requests that receive HTTP 429 responses are retried with exponential backoff. Each entry point also exposes a read-only MCP resource at reference://lexware/api containing API conventions and related usage guidance.

Setup and configuration

Node.js 20 or newer is required, along with an API token created in the Lexware Office API settings. The standard MCP configuration launches the package with npx:

{
  "mcpServers": {
    "lexware": {
      "command": "npx",
      "args": ["-y", "@lazyants/lexware-mcp-server"]
    }
  }
}

On macOS, the token can be stored with the security command. Linux setups can use secret-tool with a Secret Service implementation such as libsecret. Windows, headless environments, and environment-variable configuration use the package's configuration options. Claude Code can register the server with claude mcp add, while Claude Desktop can load it through its MCP configuration file.

To reduce the number of exposed tools, run a split command with npx, for example:

npx -y -p @lazyants/lexware-mcp-server lexware-mcp-sales

Tools and capabilities

The exposed document operations include:

• Creating and retrieving credit notes.
• Downloading credit-note files, pursuing credit notes, and opening credit-note deep links.
• Creating and retrieving quotations, with quotation file downloads and deep links.
• Creating and retrieving order confirmations, downloading their files, pursuing them, and opening deep links.
• Creating and retrieving delivery notes, downloading files, pursuing delivery notes, and opening deep links.
• Retrieving and downloading down-payment invoices and opening their deep links.
• Retrieving and downloading dunnings, pursuing them, and opening deep links.
• Listing, reading, creating, and updating contacts.

The package uses names in the form lexware_<action>_<resource>, so tool intent is visible in the MCP client inventory and schemas.

Limitations and notes

This is an unofficial community project and is not affiliated with Lexware GmbH or Haufe Group. Write operations affect live business data in the connected Lexware account; use read-only access when appropriate and test changes against a sandbox or non-critical account before production use. Keep API tokens in the OS keyring where possible and never commit them to source control. The package is licensed under FSL-1.1-MIT.