# Benethos Lexware Office MCP

> Benethos Lexware Office MCP is an open-source MCP server for finance and payments. Unofficial server linking MCP clients to a Lexware Office accounting account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/benethos-hub/lexware-office-mcp
- **MCP Registry name:** io.github.benethos-hub/benethos-lexware-office-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Contacts, vouchers and documents in a Lexware Office account become something an assistant can search and read, through the documented public REST API and an API key that the account owner creates and can revoke. The project says it is not affiliated with Lexware or Haufe-Lexware.

Its permission model is the main design idea. A fresh install enables nothing except a status tool, and each tool is switched on individually in a JSON policy file, a setup flow or a browser permissions page that shows what each tool costs in context. The policy is checked when the tool list is built and again on every call. A read-only preset covers search, read and download, while writing tools can create contacts, record vouchers, issue invoices and attach receipts.

The README warns that created records are real and legally relevant: the API cannot delete a bookkeeping voucher and a finalized invoice cannot be withdrawn. The API key is kept out of logs, tool results and error messages. It runs over stdio as a Claude Desktop extension or from PyPI, or over streamable HTTP behind a bearer token in a container.

## Features

- **Per-tool permissions:** Every tool is enabled individually in a policy file, and none is on by default.
- **Read-only preset:** Gives an assistant search, read and PDF download without any write access.
- **Contacts and vouchers:** Finds, creates and changes contacts, vouchers and documents, and shows what is unpaid.
- **Receipt upload and booking:** Uploads a receipt and books it as a voucher when write tools are enabled.
- **Built-in prompts:** Three prompts ask what is open, which receipt is missing and where a customer stands.
- **stdio or HTTP:** Runs from PyPI or a desktop extension, or as a container with bearer-token HTTP.

## Good for

- Ask which customer invoices are still unpaid
- Find the receipt that belongs to an expense
- Review where a customer stands before a call
- Upload and book a receipt from a chat
- Run a shared read-only accounting assistant in a container

## Install

### Claude Code (Terminal)

```sh
claude mcp add benethos-lexware-office-mcp -- uvx benethos-lexware-office-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `server_status`: Reports which server is running without reading any account record.
- `get_profile`: Says which Lexware account is connected.
- `create_contact`: Creates a contact when write access is enabled.
- `upload_file`: Uploads a file such as a receipt when enabled.

## FAQ

### Is it official?

No. It is unaffiliated with Lexware and uses the documented public API with your own key.

### Can the assistant change my books?

Only if you enable write tools. Writes are off by default, and the README recommends starting read-only.

### Can mistakes be undone?

Not through this API: it cannot delete a bookkeeping voucher, and a finalized invoice keeps its used number.

### Where does the API key go?

In the .env file only, not the client configuration; it is never logged or returned in tool results.

### How can I run it?

As a Claude Desktop extension, with uvx from PyPI, or as a published container image over HTTP.

### Is Benethos Lexware Office MCP free?

Yes. Benethos Lexware Office MCP is open source, so you can use and self-host it for free.

### How do I add Benethos Lexware Office MCP to Claude Code?

Run this command in your terminal: claude mcp add benethos-lexware-office-mcp -- uvx benethos-lexware-office-mcp

### What are the best alternatives to Benethos Lexware Office MCP?

The closest alternatives to Benethos Lexware Office MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/benethos-lexware-office-mcp
