CLI & Skill

Die Business OS CLI gibt dir Zugriff auf Banking und DATEV (Unternehmen Online, Rechnungswesen Lesen/Schreiben) direkt aus dem Terminal. In Kombination mit der Skill-Datei können AI-Agenten wie Claude Code die CLI automatisch nutzen.

Für AI-Agenten außerhalb der Shell (claude.ai, Cursor, Windsurf) gibt es den Hosted MCP unter mcp.business-os.de (OAuth, voller Banking- + DATEV-Funktionsumfang). Die CLI selbst bringt keinen lokalen MCP-Server mehr mit — siehe MCP Server.

Installation

npm install -g business-os-cli

Oder ohne globale Installation:

npx business-os-cli <command>

Authentifizierung

Interaktiv

business-os login

Du wirst nach deinem API Key gefragt. Der Key wird unter ~/.business-os/config.json gespeichert.

Per Umgebungsvariable

export BUSINESS_OS_API_KEY=bo_xxxxx...

API Typ setzen

Business OS unterstützt zwei APIs:

Partner API — Regulierte Banken (Sparkasse, Volksbank, Deutsche Bank, etc.)
Open Banking API — Nicht-regulierte Anbieter (American Express, PayPal, Revolut, etc.)

business-os config --api partner    # Default
business-os config --api openbanking

Claude Code Skill

Installiere die Skill-Datei, damit Claude Code die CLI automatisch nutzen kann:

business-os init

Dies kopiert eine SKILL.md nach ~/.claude/skills/business-os/. Nach einem Neustart von Claude Code erkennt dieser die Skill automatisch. Beispiel-Interaktion mit Claude Code:

User: Zeige mir meine Banking-Connections
Claude: Ruft `business-os connections list` auf und zeigt die Ergebnisse

Befehle

Connections

# Alle Verbindungen auflisten
business-os connections list

# Einzelne Verbindung abrufen
business-os connections get 9182736450918273645

# Verbindung löschen
business-os connections delete 9182736450918273645

Accounts

# Alle Konten auflisten
business-os accounts list

# Konten einer bestimmten Verbindung
business-os accounts list --connection 9182736450918273645

# Einzelnes Konto abrufen
business-os accounts get 8273645091827364509

Transactions

# Transaktionen einer Verbindung
business-os transactions list --connection 9182736450918273645

# Gefiltert nach Konto
business-os transactions list --connection 9182736450918273645 --account 8273645091827364509

# Mit Zeitraum
business-os transactions list --connection 9182736450918273645 --from 2026-01-01 --to 2026-03-24

Balances

# Tagessalden eines Kontos (Start-/End-of-Day, Cash-In/-Out, Delta)
business-os balances list --account 8273645091827364509

# Mit Zeitraum
business-os balances list --account 8273645091827364509 --from 2026-01-01 --to 2026-03-31

accounts list liefert den aktuellen Saldo pro Konto (Snapshot). balances list liefert den Verlauf über die Zeit.

Payments

# Alle Zahlungen auflisten
business-os payments list

# Zahlungsdetails abrufen
business-os payments get 7364509182736450918

# Verfügbare Templates (SEPA, SEPA_INSTANT) + unterstützende Provider
business-os payments templates

# SEPA-Zahlung initiieren
business-os payments create \
  --provider musterbank_oauth_client_de \
  --template SEPA \
  --creditor-name "Mustermann GmbH" \
  --creditor-iban "DE27100777770209299700" \
  --debtor-iban "DE89370400440532013000" \
  --amount "100.00" \
  --end-to-end-id "RE-2026-001" \
  --description "Rechnung RE-2026-001"

Der payments create Befehl gibt eine Widget-URL zurück. Der Nutzer muss diese URL öffnen, um die Zahlung per TAN zu autorisieren.

Webhook

# Aktuelle Webhook URL abrufen
business-os webhook get

# Webhook URL setzen
business-os webhook set https://hook.example.com/banking

Provider suchen

# Bank suchen
business-os providers search "Sparkasse"

# Open Banking Anbieter suchen
business-os providers search "American Express" --api openbanking

DATEV

DATEV-Verbindungen werden im Dashboard angelegt. Jede Verbindung hat eine connectionId. Multi-Mandant-Verbindungen (ReWe-Read) brauchen zusätzlich --company <id> — die companyId liefert datev companies.

Mandanten

business-os datev companies --connection <connection-id>

DATEV Unternehmen Online (DUO)

Beleg- und Kassenbuch-Ebene.

business-os datev-duo connections
business-os datev-duo belegtypen --connection <id>
business-os datev-duo kassenbuecher --connection <id>
business-os datev-duo rechnungsordner --connection <id> --typ EINGANG

# Schreiben — Payload wird 1:1 an DATEV weitergereicht
business-os datev-duo upload-beleg --connection <id> --body '{ ... }'
business-os datev-duo kassenbuch-einfach --connection <id> --body-file beleg.json
business-os datev-duo kassenbuch-advanced --connection <id> --body-file kassenbuch.json
business-os datev-duo buchungsvorschlag --connection <id> --body '{ ... }'

DATEV Rechnungswesen — Schreiben

business-os datev-rewe connections
business-os datev-rewe belegtypen --connection <id>
business-os datev-rewe steuersaetze --connection <id>

business-os datev-rewe upload-beleg --connection <id> --body '{ ... }'
business-os datev-rewe personenkonto --connection <id> --body '{ ... }'
business-os datev-rewe buchung --connection <id> --body '{ ... }'

personenkonto und buchung benötigen das RVO-Recht „Rechnungsdatenservice 1.0” auf dem Mandanten.

DATEV Rechnungswesen — Lesen

Read-only Finanzdaten pro Mandant. Typischer Ablauf: connections → permissions (welche RVO-Rechte?) → geschaeftsjahre (liefert startDatum) → susa/opos.

business-os datev-rewe-read connections
business-os datev-rewe-read permissions --connection <id>
business-os datev-rewe-read geschaeftsjahre --connection <id>
business-os datev-rewe-read geschaeftsjahr <gj-id> --connection <id>

# Finanzdaten — brauchen --fiscal-year-start (aus geschaeftsjahre.startDatum)
business-os datev-rewe-read kontenplan --connection <id> --fiscal-year-start 2026-01-01
business-os datev-rewe-read susa --connection <id> --fiscal-year-start 2026-01-01
business-os datev-rewe-read susa --connection <id> --fiscal-year-start 2026-01-01 --konto 4000
business-os datev-rewe-read buchungsdaten --connection <id> --fiscal-year-start 2026-01-01
business-os datev-rewe-read zahlungsbedingungen --connection <id> --fiscal-year-start 2026-01-01

# Offene Posten (Mahnwesen, Forderungen/Verbindlichkeiten)
business-os datev-rewe-read opos --connection <id>
business-os datev-rewe-read opos --connection <id> --filter debitoren --stichtag 2026-03-31

DATEV-Befehle laufen unter dem aktuellen Org-Scope. Bei Agentur-Keys mit mehreren Organisationen die Ziel-Org mit der globalen Option --org <id> wählen, z.B. business-os --org <org-id> datev-rewe-read connections.

Output

Alle Befehle geben JSON zurück. Du kannst die Ausgabe mit jq weiterverarbeiten:

# Nur Kontonamen anzeigen
business-os accounts list | jq '.data[].name'

# Saldo eines Kontos
business-os accounts get 8273645091827364509 | jq '.data.balance'

# Transaktionen als CSV
business-os transactions list --connection 123 | jq -r '.data[] | [.made_on, .amount, .description] | @csv'

​CLI & Skill

​Installation

​Authentifizierung

​Interaktiv

​Per Umgebungsvariable

​API Typ setzen

​Claude Code Skill

​Befehle

​Connections

​Accounts

​Transactions

​Balances

​Payments

​Webhook

​Provider suchen

​DATEV

​Mandanten

​DATEV Unternehmen Online (DUO)

​DATEV Rechnungswesen — Schreiben

​DATEV Rechnungswesen — Lesen

​Output

CLI & Skill

Installation

Authentifizierung

Interaktiv

Per Umgebungsvariable

API Typ setzen

Claude Code Skill

Befehle

Connections

Accounts

Transactions

Balances

Payments

Webhook

Provider suchen

DATEV

Mandanten

DATEV Unternehmen Online (DUO)

DATEV Rechnungswesen — Schreiben

DATEV Rechnungswesen — Lesen

Output