Lexware Office MCP服务器

一种与Lexware Office（以前称为Lexoffice）集成的MCP服务器实现，通过模型上下文协议为管理业务操作提供无缝接口。

特性

Lexware Office API覆盖范围广泛：53个工具，涵盖此服务器公开的可用读/写工作流
完整的文档生命周期：创建、最终确定和下载发票、报价、订单确认、信用票据、交货单和催款通知的PDF
联系人管理：创建、读取和更新客户和供应商
簿记：凭单、过账类别、付款和文件上传
网络钩子：创建、列出和删除事件订阅

工具

发票

工具	说明	API
`get-invoices`	列出带有可选过滤器的发票	`GET /v1/invoices`
`get-invoice-details`	获取特定发票的详细信息	`GET /v1/invoices/{id}`
`create-invoice`	以草稿形式创建发票	`POST /v1/invoices`
`finalize-invoice`	创建并立即完成发票	`POST /v1/invoices?finalize=true`

引文

工具	说明	API
`get-quotations`	列出带有可选筛选器的报价	`GET /v1/quotations`
`get-quotation-details`	获取特定报价的详细信息	`GET /v1/quotations/{id}`
`create-quotation`	以草稿形式创建报价单	`POST /v1/quotations`
`finalize-quotation`	创建并立即完成报价	`POST /v1/quotations?finalize=true`

订单确认

工具	说明	API
`get-order-confirmations`	使用可选筛选器列出订单确认	`GET /v1/order-confirmations`
`get-order-confirmation-details`	获取特定订单确认的详细信息	`GET /v1/order-confirmations/{id}`
`create-order-confirmation`	以草稿形式创建订单确认	`POST /v1/order-confirmations`
`finalize-order-confirmation`	创建并立即完成订单确认	`POST /v1/order-confirmations?finalize=true`

贷项凭单

工具	说明	API
`get-credit-notes`	列出带有可选过滤器的贷记单	`GET /v1/credit-notes`
`get-credit-note-details`	获取特定贷记单的详细信息	`GET /v1/credit-notes/{id}`
`create-credit-note`	创建贷记单作为草稿	`POST /v1/credit-notes`
`finalize-credit-note`	创建并立即完成贷记单	`POST /v1/credit-notes?finalize=true`

请问发货通知

工具	说明	API
`get-delivery-notes`	列出带有可选过滤器的交货单	`GET /v1/delivery-notes`
`get-delivery-note-details`	获取特定送货单的详细信息	`GET /v1/delivery-notes/{id}`
`create-delivery-note`	创建送货单草稿	`POST /v1/delivery-notes`
`finalize-delivery-note`	创建并立即完成交货单	`POST /v1/delivery-notes?finalize=true`

催收通知

工具	说明	API
`get-dunnings`	助手解释API不支持列出垫料	-
`get-dunning-details`	获取特定催款通知的详细信息	`GET /v1/dunnings/{id}`
`create-dunning`	为现有发票创建催款通知	`POST /v1/dunnings`
`finalize-dunning`	创建扣篮的别名（见下面的注释）	`POST /v1/dunnings?finalize=true`

关于扣篮的注意事项： Lexware Office API总是返回 voucherStatus: "draft" 对于催款通知，无论 finalize 参数。这是预期的API行为-创建后立即生成PDF。

首付款发票

工具	说明	API
`get-down-payment-invoice-details`	获取特定首付款发票的详细信息	`GET /v1/down-payment-invoices/{id}`

联系人

工具	说明	API
`get-contacts`	使用可选筛选器列出联系人	`GET /v1/contacts`
`get-contact-details`	获取特定联系人的详细信息	`GET /v1/contacts/{id}`
`create-contact`	创建新联系人（客户或供应商）	`POST /v1/contacts`
`update-contact`	更新现有联系人	`PUT /v1/contacts/{id}`

凭证（记账）

工具	说明	API
`get-vouchers`	列出带有可选过滤器的记账凭证	`GET /v1/voucherlist`
`get-voucher-details`	获取特定凭证的详细信息	`GET /v1/vouchers/{id}`
`create-voucher`	创建记账凭证（例如传入发票）	`POST /v1/vouchers`
`update-voucher`	更新现有记账凭证	`PUT /v1/vouchers/{id}`
`list-posting-categories`	列出记账的过账类别	`GET /v1/posting-categories`

文章（产品目录）

工具	说明	API
`get-articles`	列出带有可选筛选器的文章	`GET /v1/articles`
`get-article-details`	获取特定文章的详细信息	`GET /v1/articles/{id}`
`create-article`	创建新文章	`POST /v1/articles`
`update-article`	更新现有文章	`PUT /v1/articles/{id}`
`delete-article`	删除文章	`DELETE /v1/articles/{id}`

文件和文档

工具	说明	API
`get-file`	按文件ID下载文件（PDF或XML）	`GET /v1/files/{id}`
`get-document-file`	按文档ID下载文档的PDF；可能需要先渲染PDF	`GET /v1/{docType}/{id}/file`
`upload-file`	上传文件并接收文件ID	`POST /v1/files`
`upload-file-to-voucher`	上传文件并将其附加到凭证上	`POST /v1/vouchers/{id}/files`

支付

工具	说明	API
`get-payments`	获取发票或凭证的付款信息	`GET /v1/payments`
`get-payment-conditions`	列出可用的付款条件（Zahlungsbedingungen）	`GET /v1/payment-conditions`

重复模板

工具	说明	API
`get-recurring-templates`	列出定期发票模板	`GET /v1/recurring-templates`

活动订阅（Webhooks）

工具	说明	API
`list-event-subscriptions`	列出所有webhook事件订阅	`GET /v1/event-subscriptions`
`get-event-subscription`	获取特定事件订阅的详细信息	`GET /v1/event-subscriptions/{id}`
`create-event-subscription`	创建新的webhook事件订阅	`POST /v1/event-subscriptions`
`delete-event-subscription`	删除事件订阅	`DELETE /v1/event-subscriptions/{id}`

公司和参考数据

工具	说明	API
`get-profile`	获取公司简介（名称、地址、税务设置）	`GET /v1/profile`
`list-countries`	列出国家及其税收分类	`GET /v1/countries`
`list-print-layouts`	列出可用的打印布局	`GET /v1/print-layouts`

权限模型

工具分为三层。您可以通过禁用Claude/MCP配置中的工具来限制访问：

级别	允许	禁用这些工具
只读	全部 `get-` 和 `list-` 工具	`create-`, `update-`, `delete-`, `finalize-`, `upload-*`
草稿模式	+创建、更新、删除、上传工具	`finalize-invoice`, `finalize-quotation`, `finalize-order-confirmation`, `finalize-credit-note`, `finalize-delivery-note`, `finalize-dunning`
完全访问	所有工具	_（无）_

示例（草稿模式——无定稿）：

{
  "mcpServers": {
    "lexware-office": {
      "disabledTools": [
        "finalize-invoice",
        "finalize-quotation",
        "finalize-order-confirmation",
        "finalize-credit-note",
        "finalize-delivery-note",
        "finalize-dunning"
      ]
    }
  }
}

配置

获取Lexware Office API密钥

访问 https://app.lexoffice.de/addons/public-api 获取您的API密钥。

先决条件

Node.js 22或更高版本

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

码头工人

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

构建

Docker构建：

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

许可证

该项目根据MIT许可证获得许可。有关完整详细信息，请参阅项目存储库中的LICENSE文件。

MCP Lexware Office

快速接入

详细介绍