Agentic Ventures Wiki

mcp-lexware

2 Min. Lesezeit

mcp-lexware (Repo)

Eigener Python-MCP fuer Lexware-Office-API. Ersetzt den alten TypeScript-Clone mcp-lexware-office/ durch sauberen Python-Eigenbau mit Read und Write-CRUD.

Status

  • v0.1 Skeleton fertig 2026-05-18 — 16 Tools (9 Read + 7 Write) registriert, uv tool install --editable getestet, kein Import-Fehler
  • Live-Test ausstehend — benoetigt LEXWARE_API_KEY von Marvins Lexware-Sandbox
  • GitHub-Repo: noch nicht angelegt (lokales Git-Repo TODO)

Struktur

mcp-lexware/
├── README.md
├── pyproject.toml
├── .env.local.example
├── .gitignore
└── src/mcp_lexware/
    ├── __init__.py
    └── server.py        # FastMCP + Auth + 16 Tools (9 Read + 7 Write) (~380 LOC)

Tools v0.1

Read (9): list_invoices, get_invoice, list_contacts, get_contact, list_vouchers, get_voucher, list_posting_categories, list_countries, get_file

Write (7): create_contact, update_contact, create_invoice_draft, finalize_invoice, create_voucher, attach_voucher_file, export_datev_csv

Details siehe lexware oder Repo-README.

Architektur-Highlights

  • Bearer-API-Key (kein OAuth) — Header Authorization: Bearer <key>
  • Idempotency-Keys als UUID4 pro POST/PUT
  • Optimistic-Lock bei update_contact via version-Read-Modify-Write
  • Response-Compaction ab 50KB analog mcp-ticketpay/mcp-zettle
  • Pattern-konsistent mit mcp-zettle, mcp-papierkram, mcp-ticketpay

Migration vom Legacy-Repo

Der alte mcp-lexware-office/ (TypeScript-Clone von JannikWempe) wird als deprecated markiert. Alle 8 Read-Tools wurden semantisch in diesem Python-MCP nachgebaut. Migration in Claude Code:

claude mcp remove lexware-office
claude mcp add lexware --transport http http://127.0.0.1:8774/mcp

Legacy-Repo bleibt fuer Referenz, wird nicht weiter gepflegt.

Standard-Stack-Layer-Strategie

Dieser MCP ist der Buchhaltungs-Layer fuer alle KMU-Kunden mit Lexware (parallel zu mcp-papierkram fuer Papierkram-Nutzer und mcp-sevdesk fuer sevDesk-Nutzer). Erster Kunde: Woehrle. Anschluss-Kunden: alle KMU mit lexoffice-Buchhaltung die wir akquirieren.

Nicht-Ziele (v0.1)

  • Webhooks (Push-Listener fuer eingehende Belege) — kommt in v0.2
  • OCR-Auto-Buchung — kommt mit zweitem Kunden
  • Multi-Tenant-Architektur — kommt mit Hosting-Phase
  • lexware — Setup-Doku
  • mcp-lexware-office — alter TypeScript-Clone, deprecated
  • mcp-zettle — Schwester-Repo, gleicher Stack, gleiches Pattern
  • plan — Implementierungs-Plan mit Unit 1.4 = mcp-lexware-office v2 (jetzt: Python-Rewrite)
  • mcp-best-practices — Pattern + Audit-Checkliste

Graphansicht

Backlinks