Lexware Office MCP Server

Using a customLEXWARE_KEYRING_SERVICE(e.g.acme)? SetTargetNametoapi-token.acmeto match — the server looks the token up under<account>.<service>.

secret-tool store --label="Lexware Office API" service lexware-mcp username api-token # (prompts for the token value)

Once stored, MCP config files need no credentials at all — the server reads the token from the keyring at startup.

If you prefer not to use the keyring, setLEXWARE_API_TOKENin your shell or MCP client config:

export LEXWARE_API_TOKEN=your-token-here

Optionally override the webhook-signature public key used bylexware_verify_webhook_signature(by default fetched from Lexware and cached):

export LEXWARE_WEBHOOK_PUBLIC_KEY="$(cat lexware-webhook-public.pem)"

Use split servers to reduce context size — pick only the splits you need.

Add to~/.claude/settings.json. If you stored the token in the OS keyring under the default service namelexware-mcp(recommended), noenvkey is needed:

{ "mcpServers": { "lexware": { "command": "npx", "args": ["-y", "@lazyants/lexware-mcp-server"] } } }

If you prefer the environment variable approach:

{ "mcpServers": { "lexware": { "command": "npx", "args": ["-y", "@lazyants/lexware-mcp-server"], "env": { "LEXWARE_API_TOKEN": "your-token-here" } } } }

Use split servers to reduce context size — pick only the entry points you need. The-p @lazyants/lexware-mcp-serverflag tellsnpxwhich package to source the command from; the final argument (e.g.lexware-mcp-sales) is the specific entry-point binary defined in that package (seeEntry Points):

{ "mcpServers": { "lexware-sales": { "command": "npx", "args": ["-y", "-p", "@lazyants/lexware-mcp-server", "lexware-mcp-sales"] }, "lexware-contacts": { "command": "npx", "args": ["-y", "-p", "@lazyants/lexware-mcp-server", "lexware-mcp-contacts"] } } }

Multi-account example (two Lexware companies, tokens stored under separate keyring service names):

{ "mcpServers": { "lexware-company-a": { "command": "npx", "args": ["-y", "@lazyants/lexware-mcp-server"], "env": { "LEXWARE_KEYRING_SERVICE": "lexware-company-a" } }, "lexware-company-b": { "command": "npx", "args": ["-y", "@lazyants/lexware-mcp-server"], "env": { "LEXWARE_KEYRING_SERVICE": "lexware-company-b" } } } }

Add toclaude_desktop_config.json. With the OS keyring (recommended — assumes the token is stored under the default service namelexware-mcp):

{ "mcpServers": { "lexware": { "command": "npx", "args": ["-y", "@lazyants/lexware-mcp-server"] } } }

{ "mcpServers": { "lexware": { "command": "npx", "args": ["-y", "@lazyants/lexware-mcp-server"], "env": { "LEXWARE_API_TOKEN": "your-token-here" } } } }

lexware_create_invoice(supportsfinalize=trueat creation),lexware_get_invoice,lexware_download_invoice_file,lexware_pursue_invoice,lexware_deeplink_invoice

lexware_create_credit_note,lexware_get_credit_note,lexware_download_credit_note_file,lexware_pursue_credit_note,lexware_deeplink_credit_note

lexware_create_quotation,lexware_get_quotation,lexware_download_quotation_file,lexware_deeplink_quotation

lexware_create_order_confirmation,lexware_get_order_confirmation,lexware_download_order_confirmation_file,lexware_pursue_order_confirmation,lexware_deeplink_order_confirmation

lexware_create_delivery_note,lexware_get_delivery_note,lexware_download_delivery_note_file,lexware_pursue_delivery_note,lexware_deeplink_delivery_note

lexware_get_down_payment_invoice,lexware_download_down_payment_invoice_file,lexware_deeplink_down_payment_invoice

lexware_get_dunning,lexware_download_dunning_file,lexware_pursue_dunning,lexware_deeplink_dunning

Voucherlist (1 tool) — sales, bookkeeping

lexware_list_contacts,lexware_get_contact,lexware_create_contact,lexware_update_contact,lexware_deeplink_contact

lexware_list_articles,lexware_get_article,lexware_create_article,lexware_update_article,lexware_delete_article

lexware_list_vouchers,lexware_get_voucher,lexware_create_voucher,lexware_update_voucher,lexware_upload_voucher_file,lexware_deeplink_voucher

lexware_create_event_subscription,lexware_list_event_subscriptions,lexware_get_event_subscription,lexware_delete_event_subscription,lexware_verify_webhook_signature

lexware_upload_file,lexware_download_file,lexware_get_file_status,lexware_deeplink_file

lexware_list_recurring_templates,lexware_get_recurring_template,lexware_deeplink_recurring_template

- Use the OS keyringto keep your API token out of config files and shell history entirely (seeConfiguration)
- Never commit your API tokento version control
- Useread-onlyaccess when you only need to list/get resources
- Create, update, and delete tools modify real business data— invoices, contacts, and accounting records in your Lexware account
- Rate limiting is handled automatically: requests retry with exponential backoff on 429, including file uploads — the multipart body is rebuilt fresh on every retry attempt, so it can be replayed safely

Commit, andmerge the version bump tomainbefore creating the release. Then create the tag yourself, on a SHA you have checked, and only then create the release from it:

V=X.Y.Z && PR=<release-pr-number> && SHA="$(gh pr view "$PR" --json mergeCommit -q .mergeCommit.oid)" && test -n "$SHA" && git fetch origin main && git merge-base --is-ancestor "$SHA" origin/main && PKG="$(git show "$SHA:package.json")" && test "$(printf '%s' "$PKG" | node -pe 'JSON.parse(require("fs").readFileSync(0,"utf8")).version')" = "$V" && CL="$(git show "$SHA:CHANGELOG.md")" && printf '%s\n' "$CL" | awk -v v="$V" 'index($0,"## ["v"]")==1{f=1;next} /^## \[/{f=0} /^\[[0-9]+\.[0-9]+\.[0-9]+\]:/{f=0} f' > "/tmp/notes-v$V.md" && grep -q '[^[:space:]]' "/tmp/notes-v$V.md" && git tag -a "v$V" "$SHA" -m "v$V" && git push origin "v$V" && gh release create "v$V" --verify-tag --notes-file "/tmp/notes-v$V.md"