home / mcp / lexware office mcp server

Lexware Office MCP Server

Provides access to Lexware Office data via MCP to fetch invoices, invoice details, contacts, posting categories, and country tax classifications.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "jannikwempe-mcp-lexware-office": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "LEXWARE_OFFICE_API_KEY",
        "mcp-lexware-office"
      ],
      "env": {
        "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Lexware Office MCP Server lets you interact with Lexware Office data through a Model Context Protocol interface. You can retrieve invoices, invoice details, contacts, posting categories, and country tax classifications in a centralized way to power your business workflows, analytics, or integrations.

How to use

You use this MCP server through an MCP client that queries its endpoints to fetch data from Lexware Office. The available actions cover invoices, invoice details, contacts, posting categories, and country tax classifications. Each action returns the corresponding Lexware Office data so you can present it in your applications, dashboards, or automation rules.

Common usage patterns include listing invoices with optional status and pagination, retrieving a specific invoice by ID, filtering contacts by name or email, and listing countries with their tax classifications. Combine filters to narrow results, then iterate through results to build your workflows or display data in your UI.

How to install

Prerequisites: Node.js 22 or higher.

Choose your runtime method below and follow the steps to run the MCP server locally.

Option A: Run via Docker

{
  "mcpServers": {
    "mcp-lexware-office": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LEXWARE_OFFICE_API_KEY", "mcp-lexware-office"],
      "env": {
        "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Option B: Run via NPX

{
  "mcpServers": {
    "mcp-lexware-office": {
      "command": "npx",
      "args": ["-y", "JannikWempe/mcp-lexware-office"],
      "env": {
        "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Configuration and usage notes

Before you start, obtain a Lexware Office API key from the Lexware Office API page. Store it securely and set it in the environment when you run the MCP server to authorize requests.

The server exposes a set of tools you can call via your MCP client. The key endpoints are designed to fetch data from Lexware Office and present it to your application. Ensure your client respects any rate limits and handles authentication via the API key you provide.

Security considerations

Protect your Lexware Office API key as a sensitive credential. Do not commit it to source control or share it publicly. Use environment variables or secret management to pass the key to the MCP server runtime.

Available tools

get-invoices

Fetch a paginated list of invoices from Lexware Office. Supports optional filters for status, page, and size to control results.

get-invoice-details

Retrieve detailed information for a single invoice identified by its UUID.

get-contacts

Retrieve contacts from Lexware Office with optional filters for email, name, number, customer/vendor roles, and pagination. Filters are combined with AND.

list-posting-categories

Obtain a list of posting categories for bookkeeping vouchers, with an optional type filter (income or outgo).

list-countries

Get the known Lexware Office countries and their tax classifications, optionally filtered by taxClassification (de, intraCommunity, or thirdPartyCountry).