Business OS CLI

CLI + Claude Code Skill für die Business OS API — programmierbarer Zugriff auf Banking (PSD2-Bankdaten und SEPA-Zahlungen über 3.300+ Banken) und DATEV (Unternehmen Online, Rechnungswesen Lesen/Schreiben).

Für KI-Agenten außerhalb der Shell (claude.ai, Cursor, Windsurf) gibt es den Hosted MCP unter mcp.business-os.de (OAuth, voller Funktionsumfang). Die CLI bringt bewusst keinen eigenen lokalen MCP mehr mit.

Installation

npm install -g business-os-cli

Oder ohne globale Installation:

npx business-os-cli <command>

Quick Start

# 1. API-Key aus dem Dashboard hinterlegen (interaktiv)
business-os login

# 2. Liste deine Banking-Connections
business-os connections list

# 3. Konten + Transaktionen abrufen
business-os accounts list --connection <id>
business-os transactions list --connection <id> --account <id>

API-Key bekommst du im Business OS Dashboard.

Commands

Banking

| Command | Beschreibung | |---|---| | login | API-Key interaktiv hinterlegen | | config | Lokale Konfiguration anzeigen/setzen | | connections list\|get\|delete | Banking-Connections verwalten | | accounts list\|get | Konten abfragen (inkl. aktuellem Saldo) | | balances list | Tägliche Saldenreihe eines Kontos (SOD/EOD/Cash-In/-Out/Delta) | | transactions list | Transaktionen listen | | payments list\|get\|templates\|create | SEPA-Zahlungen + Templates | | webhook get\|set | Webhook-URL konfigurieren | | providers search | Banken/Provider suchen |

DATEV

| Command | Beschreibung | |---|---| | datev companies | Mandanten einer Verbindung (liefert companyId) | | datev-duo connections\|belegtypen\|kassenbuecher\|rechnungsordner | DATEV Unternehmen Online — lesen | | datev-duo upload-beleg\|kassenbuch-einfach\|kassenbuch-advanced\|buchungsvorschlag | DUO — schreiben (--body/--body-file) | | datev-rewe connections\|belegtypen\|steuersaetze | Rechnungswesen Write — lesen | | datev-rewe upload-beleg\|personenkonto\|buchung | Rechnungswesen Write — schreiben (--body/--body-file) | | datev-rewe-read connections\|permissions\|geschaeftsjahre\|geschaeftsjahr | Rechnungswesen Read — Stammdaten | | datev-rewe-read kontenplan\|susa\|buchungsdaten\|zahlungsbedingungen\|opos | Rechnungswesen Read — Finanzdaten (BWA, OPOS …) |

Sonstiges

| Command | Beschreibung | |---|---| | init | Claude Code Skill installieren |

DATEV-Mandanten: Multi-Mandant-ReWe-Read-Verbindungen brauchen zusätzlich --company <id> (aus datev companies). Read-Befehle brauchen meist --fiscal-year-start <YYYY-MM-DD> aus datev-rewe-read geschaeftsjahre. Schreib-Befehle reichen ihren --body JSON 1:1 an DATEV weiter.

Volle Doku: docs.business-os.de

KI-Agenten (MCP)

Diese CLI bringt keinen eigenen MCP-Server mit. Für KI-Agenten gibt es den Hosted Remote MCP unter mcp.business-os.de — OAuth 2.1, voller Funktionsumfang (Banking + DATEV), ohne lokale Installation. Als Custom Connector in claude.ai / Cursor / Windsurf einbinden.

Für Claude Code (Shell vorhanden) ist die CLI selbst der bessere Weg: business-os init installiert die Skill, die Claude die Befehle beibringt.

Details: docs.business-os.de/sdks/mcp

Authentifizierung per Env-Variable (CI, Scripts)

export BUSINESS_OS_API_KEY=bo_xxxxx...
business-os connections list

Multi-Tenant: --org Flag (Agency-Keys)

Seit v2.0 sind alle API-Calls URL-scoped — der Tenant ist im URL-Pfad, nicht in einem Header. Vergessen ist syntaktisch unmöglich (siehe URL_REFACTOR.md).

Org-Key (Zugriff auf 1 Org): Auto-Resolve, keine Aktion nötig.

business-os connections list   # nutzt automatisch die Org des API-Keys

Agency-Key (Zugriff auf N Orgs eines Mandanten-Stamms): Org muss spezifiziert werden — sonst Fehler mit Org-Liste.

# Pro Call
business-os --org <org-uuid> connections list

# Persistent als Default (in ~/.business-os/config.json)
business-os config --org <org-uuid>
business-os connections list   # nutzt die persisted Org

# Per Env-Var (CI, Scripts)
export BUSINESS_OS_ORG_ID=<org-uuid>
business-os connections list

Priorität (höchste zuerst): --org Flag > BUSINESS_OS_ORG_ID env > config-File > Auto-Resolve.

E2E-Tests

Voraussetzungen: dist/ gebaut (npm run build), .env mit BO_GREYT_API_KEY (siehe .env.example).

./test/e2e.sh

Output: 10 Tests gegen Live-API (read + reversible write), Skip-Liste für interaktive/destruktive Commands.

License

MIT © Greyt GmbH