Xero MCP Server

Der Xero MCP Server verbindet KI-Assistenten mit der Buchhaltung in Xero. Statt Berichte von Hand zu exportieren oder sich durch Menüs zu klicken, fragen Sie den Assistenten etwa nach offenen Rechnungen, der Gewinn- und Verlustrechnung eines Zeitraums oder den Umsätzen mit einem bestimmten Kunden. Der Server stellt dafür rund fünfzig Werkzeuge bereit, die sich auf die Xero-API stützen. Er liegt laut GitHub in der Organisation XeroAPI, steht unter der MIT-Lizenz und ist nicht archiviert. Die Entwickler-FAQ von Xero verlinkt den MCP-Server selbst und nennt Claude Desktop und Cursor als getestete Clients; der letzte Push im Repository stammt von Juni 2026.

Was ist der Xero MCP Server?

Xero ist eine Buchhaltungssoftware in der Cloud, die vor allem kleine und mittlere Unternehmen nutzen. Der MCP-Server ist eine Brücke zwischen dem Model Context Protocol und der Xero-API. Er läuft als lokaler Node.js-Prozess auf Ihrem Rechner, meldet sich mit Ihren API-Zugangsdaten bei Xero an und gibt dem Assistenten die Funktionen als Werkzeuge. Der Assistent entscheidet im Gespräch, welches Werkzeug er aufruft, und zeigt Ihnen das Ergebnis.

Was kann der Assistent damit tun?

Lesend deckt der Server den Kern der Buchhaltung ab: Konten und Kontogruppen, Kontakte, Rechnungen, Gutschriften, Zahlungen, Angebote, Artikel, manuelle Journale, Banktransaktionen, Steuersätze und Tracking-Kategorien. Dazu kommen Berichte wie Gewinn- und Verlustrechnung, Bilanz, Probebilanz und Altersstrukturen für Forderungen und Verbindlichkeiten sowie die Daten der Organisation. Schreibend lassen sich unter anderem Kontakte, Rechnungen, Gutschriften, Angebote, Artikel, Zahlungen, Banktransaktionen und manuelle Journale anlegen; die meisten dieser Objekte können auch geändert werden. Zusätzlich gibt es Werkzeuge für Payroll, etwa Mitarbeiter, Urlaub und Zeiterfassung. Laut README funktionieren Payroll-Abfragen nur mit der Region Neuseeland oder Großbritannien.

Einrichtung und Anmeldung

Sie brauchen Node.js ab Version 18, ein Xero-Entwicklerkonto mit API-Zugangsdaten und eine sogenannte Custom Connection, die in der Xero-Entwicklerumgebung angelegt wird. Der Client startet den Server mit npx -y @xeroapi/xero-mcp-server@latest, die Zugangsdaten werden als Umgebungsvariablen übergeben. Welche Berechtigungsbereiche (Scopes) gelten, hängt laut README vom Anlagedatum der Custom Connection ab: Verbindungen vor dem 29. April 2026 nutzen gebündelte V1-Scopes, spätere die feineren V2-Scopes. Der Server probiert zuerst V1 und weicht auf V2 aus; mit der Variable XERO_SCOPES lassen sie sich überschreiben. Alternativ ist eine Anmeldung per Bearer-Token möglich. Zum Üben empfiehlt die README ausdrücklich die Demo-Firma von Xero mit Beispieldaten.

Sicherheit und Grenzen

Der Server kann Buchhaltungsdaten nicht nur lesen, sondern auch erzeugen und ändern, bei Payroll-Zeiterfassungen sogar löschen. Das ist bei Finanzdaten heikel: Ein falsch verstandener Auftrag kann eine Rechnung erzeugen oder eine Zahlung buchen. Beginnen Sie deshalb mit der Demo-Firma, prüfen Sie jede schreibende Aktion vor der Bestätigung und vergeben Sie nur die Scopes, die Sie wirklich brauchen. Abgerufene Rechnungen, Namen und Beträge gelangen in den Kontext des Sprachmodells und damit zum Modellanbieter; das ist für Kundendaten datenschutzrechtlich zu bewerten. Die Zugangsdaten gehören nicht in ein Repository.

Kosten

Der MCP-Server ist kostenlos und quelloffen. Xero selbst ist ein kostenpflichtiger Dienst; Tarife und die Bedingungen für den API-Zugang finden Sie auf den offiziellen Seiten von Xero, wir nennen hier keine Beträge. Die Demo-Firma eignet sich zum Ausprobieren.

Für wen lohnt sich der Xero MCP Server?

Er lohnt sich für Unternehmen und Berater, die bereits mit Xero arbeiten und Auswertungen in Alltagssprache abrufen wollen: Welche Rechnungen sind überfällig? Wie entwickeln sich die Ausgaben je Kostenstelle? Auch Entwickler, die Buchhaltungsabläufe automatisieren, nutzen ihn zum schnellen Ausprobieren der API. Wer Xero nicht verwendet, hat keinen Nutzen davon, und für den unbeaufsichtigten Betrieb mit Schreibrechten auf echte Buchhaltungsdaten ist besondere Vorsicht geboten.

Node.js ab Version 18, ein Xero-Entwicklerkonto mit API-Zugangsdaten (Custom Connection) und ein MCP-fähiger Client; für Payroll-Abfragen die Region Neuseeland oder Großbritannien.

Der Xero MCP Server läuft lokal und verbindet Ihren Assistenten mit der Xero-Buchhaltung. Dieser Ratgeber führt durch die Einrichtung.

Schritt 1: Voraussetzungen

Sie brauchen Node.js ab Version 18, ein Xero-Entwicklerkonto und einen MCP-fähigen Client wie Claude Desktop oder Cursor, die Xero laut Entwickler-FAQ getestet hat.

Demo-Firma anlegen

Beginnen Sie nicht mit Ihren echten Büchern. Xero bietet eine Demo-Firma mit Beispieldaten an, die sich über „My Xero“ zurücksetzen lässt. So können Sie schreibende Aktionen gefahrlos ausprobieren.

Schritt 2: Custom Connection anlegen

Legen Sie in der Xero-Entwicklerumgebung eine Custom Connection an und notieren Sie Client-ID und Client-Secret. Behandeln Sie beides wie ein Passwort. Welche Scopes gelten, hängt vom Anlagedatum ab: Verbindungen vor dem 29. April 2026 nutzen V1-Scopes, spätere V2-Scopes; mit XERO_SCOPES lassen sie sich überschreiben.

Schritt 3: Server im Client eintragen

Tragen Sie unter mcpServers einen Eintrag mit dem Befehl npx und den Argumenten -y und @xeroapi/xero-mcp-server@latest ein. Übergeben Sie Client-ID und Client-Secret als Umgebungsvariablen und starten Sie den Client neu.

Schritt 4: Erste Anfragen

Bitten Sie den Assistenten, die Organisationsdetails abzurufen, danach die offenen Rechnungen aufzulisten oder die Gewinn- und Verlustrechnung eines Zeitraums zu erstellen. Prüfen Sie die Zahlen stichprobenartig in Xero.

Vorsicht bei Schreibzugriff

Der Server kann Rechnungen, Zahlungen und Journale anlegen und ändern. Lassen Sie sich jede schreibende Aktion vor der Bestätigung zeigen und vergeben Sie nur die nötigen Scopes.

npx -y @xeroapi/xero-mcp-server@latest

Über die Zugangsdaten einer Custom Connection aus der Xero-Entwicklerumgebung (Client-ID und Client-Secret) oder alternativ per Bearer-Token.

Lesender und schreibender Zugriff auf die verbundene Xero-Organisation im Umfang der vergebenen Scopes: Rechnungen, Kontakte, Zahlungen, Journale und weitere Objekte können angelegt und geändert werden.

Der Server läuft lokal und spricht nur mit der Xero-API. Abgerufene Buchhaltungsdaten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Versehentlich erzeugte oder geänderte Rechnungen, Zahlungen und Journale, zu weit gefasste Scopes, Zugangsdaten in Konfigurationsdateien und die Weitergabe von Kundendaten an den Modellanbieter.