mcp-lexware-office

Lexware Office MCP Server

An MCP server implementation that integrates with Lexware Office (formerly known as Lexoffice), providing a seamless interface for managing business operations through the Model Context Protocol.

Features

• Lexware Office Integration: Direct integration with the Lexware Office API
• Business Operations: Manage invoices, contacts, and other business documents (read-only as of now)

Tools

The following tools are available through this MCP server:

• get-invoices

  • Get a list of invoices from Lexware Office
  • Inputs:
    • status (array of strings, optional): Filter by invoice status ("open", "draft", "paid", "paidoff", "voided"). Default: all statuses
    • page (number, optional): Page number to retrieve (starts at 0). Default: 0
    • size (number, optional): Number of invoices per page (1-250). Default: 250

• get-invoice-details

  • Get details of an invoice from Lexware Office
  • Inputs:
    • id (string): The UUID of the invoice

• get-contacts

  • Get contacts from Lexware Office with optional filters that are combined with a logical AND
  • Inputs:
    • email (string, optional): Filter contacts by email address (supports wildcards)
    • name (string, optional): Filter contacts by name (supports wildcards)
    • number (number, optional): Filter contacts by contact number
    • customer (boolean, optional): Filter contacts by customer role
    • vendor (boolean, optional): Filter contacts by vendor role
    • page (number, optional): Page number to retrieve (starts at 0). Default: 0
    • size (number, optional): Number of contacts per page (1-250). Default: 250

• list-posting-categories

  • Retrieve list of posting categories for bookkeeping vouchers
  • Inputs:
    • type (string, optional): Filter posting categories by type ("income" or "outgo")

• list-countries

  • Retrieve list of countries known to lexoffice with their tax classifications
  • Inputs:
    • taxClassification (string, optional): Filter countries by tax classification ("de" for Germany, "intraCommunity" for EU countries, or "thirdPartyCountry" for non-EU countries)

Configuration

Getting a Lexware Office API key

Visit https://app.lexoffice.de/addons/public-api to get your API key.

Prerequisites

• Node.js 22 or higher

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

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"
			}
		}
	}
}

NPX

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

Build

Docker build:

docker build -t mcp-lexware-office:latest -f Dockerfile .

License

This project is licensed under the MIT License. See the LICENSE file in the project repository for full details.