Xero MCP-Server

Dies ist eine Model Context Protocol (MCP)-Serverimplementierung für Xero. Sie bildet eine Brücke zwischen dem MCP-Protokoll und der Xero-API und ermöglicht einen standardisierten Zugriff auf die Buchhaltungs- und Geschäftsfunktionen von Xero.

Merkmale

Xero OAuth2-Authentifizierung mit benutzerdefinierten Verbindungen
Kontaktverwaltung
Kontenplanverwaltung
Rechnungserstellung und -verwaltung
MCP-Protokoll-Konformität

Voraussetzungen

Node.js (v18 oder höher)
npm oder pnpm
Ein Xero-Entwicklerkonto mit API-Anmeldeinformationen

Dokumente und Links

Aufstellen

Erstellen Sie ein Xero-Konto

Wenn Sie noch kein Xero-Konto und keine Xero-Organisation haben, können Sie eines erstellen, indem Sie sich hier mit der kostenlosen Testversion anmelden.

Wir empfehlen Ihnen, zunächst eine Demo-Firma zu verwenden, da diese bereits Beispieldaten enthält. Wechseln Sie nach der Anmeldung über das Dropdown-Menü oben links dorthin und wählen Sie „Demo-Firma“. Sie können die Daten einer Demo-Firma jederzeit zurücksetzen oder das Land ändern, indem Sie über das Dropdown-Menü oben links zu „Mein Xero“ navigieren.

HINWEIS: Um gehaltsspezifische Abfragen zu verwenden, sollte die Region entweder Neuseeland oder Großbritannien sein.

Authentifizierung

Der Xero MCP-Server unterstützt zwei Authentifizierungsmodi:

1. Benutzerdefinierte Verbindungen

Dies ist die bessere Wahl für Tests und Entwicklung, da Sie Client-ID und Geheimnisse für eine bestimmte Organisation angeben können. Dies ist auch der empfohlene Ansatz, wenn Sie dies in MCP-Clients von Drittanbietern wie Claude Desktop integrieren.

Konfigurieren Ihres Xero-Entwicklerkontos

Richten Sie eine benutzerdefinierte Verbindung gemäß diesen Anweisungen ein: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

Derzeit sind für alle Sitzungen folgende Bereiche erforderlich: Bereiche

Integration des MCP-Servers mit Claude Desktop

Um den MCP-Server zu Claude hinzuzufügen, gehen Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten und fügen Sie Folgendes zu Ihrer Datei claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

HINWEIS: Wenn Sie den Abschnitt „Befehl“ des Node Version Managers verwenden "command": "npx" ändern Sie ihn in den vollständigen Pfad zur ausführbaren Datei, z. B.: your_home_directory/.nvm/versions/node/v22.14.0/bin/npx auf Mac/Linux oder "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx" unter Windows

2. Inhaber-Token

Dies ist die bessere Wahl, wenn Sie mehrere Xero-Konten zur Laufzeit unterstützen und dem MCP-Client bei Bedarf die Ausführung eines Authentifizierungsflusses (z. B. PKCE) ermöglichen möchten. Verwenden Sie in diesem Fall die folgende Konfiguration:

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token"
      }
    }
  }
}

HINWEIS: Das XERO_CLIENT_BEARER_TOKEN hat Vorrang vor der XERO_CLIENT_ID , sofern definiert.

Verfügbare MCP-Befehle

list-accounts : Ruft eine Liste der Konten ab
list-contacts : Ruft eine Kontaktliste von Xero ab
list-credit-notes : Ruft eine Liste der Gutschriften ab
list-invoices : Ruft eine Liste der Rechnungen ab
list-items : Ruft eine Liste von Elementen ab
list-organisation-details : Details zu einer Organisation abrufen
list-profit-and-loss : Gewinn- und Verlustbericht abrufen
list-quotes : Ruft eine Liste mit Zitaten ab
list-tax-rates : Ruft eine Liste der Steuersätze ab
list-payments : Ruft eine Liste der Zahlungen ab
list-trial-balance : Rufen Sie einen Bilanzbericht ab
list-profit-and-loss : Gewinn- und Verlustbericht abrufen
list-bank-transactions : Ruft eine Liste der Bankkontotransaktionen ab
list-payroll-employees : Ruft eine Liste der Lohn- und Gehaltsabrechnungsmitarbeiter ab
list-report-balance-sheet : Einen Bilanzbericht abrufen
list-payroll-employee-leave : Abrufen der Urlaubsaufzeichnungen eines Lohnbuchhalters
list-payroll-employee-leave-balances : Urlaubsguthaben eines Lohnbuchhalters abrufen
list-payroll-employee-leave-types : Ruft eine Liste der Gehaltsabrechnungsurlaubsarten ab
list-payroll-leave-periods : Ruft eine Liste der Urlaubszeiten eines Lohnbuchhalters ab
list-payroll-leave-types : Rufen Sie eine Liste aller verfügbaren Urlaubsarten in Xero Payroll ab
list-aged-receivables-by-contact : Ruft die überfälligen Forderungen für einen Kontakt ab
list-aged-payables-by-contact : Ruft die überfälligen Verbindlichkeiten für einen Kontakt ab
list-contact-groups : Ruft eine Liste der Kontaktgruppen ab
create-contact : Einen neuen Kontakt erstellen
create-credit-note : Erstellen Sie eine neue Gutschrift
create-invoice : Eine neue Rechnung erstellen
create-payment : Eine neue Zahlung erstellen
create-quote : Neues Angebot erstellen
create-credit-note : Erstellen Sie eine neue Gutschrift
create-payroll-timesheet : Erstellen Sie ein neues Arbeitszeitblatt für die Lohn- und Gehaltsabrechnung
update-contact : Aktualisieren Sie einen vorhandenen Kontakt
update-invoice : Aktualisieren Sie einen vorhandenen Rechnungsentwurf
update-quote : Aktualisieren Sie einen vorhandenen Angebotsentwurf
update-credit-note : Aktualisieren Sie einen vorhandenen Gutschriftsentwurf
update-payroll-timesheet-line : Aktualisieren Sie eine Zeile in einem vorhandenen Lohn- und Gehaltsabrechnungs-Zeitnachweis
approve-payroll-timesheet : Genehmigen Sie einen Stundenzettel für die Gehaltsabrechnung
revert-payroll-timesheet : Setzt einen genehmigten Lohn- und Gehaltsabrechnungs-Zeitnachweis zurück
add-payroll-timesheet-line : Neue Zeile zu einem vorhandenen Lohn- und Gehaltsabrechnungs-Zeitnachweis hinzufügen
delete-payroll-timesheet : Löscht eine vorhandene Lohn- und Gehaltszeittabelle
get-payroll-timesheet : Ruft eine vorhandene Lohn- und Gehaltsabrechnung ab

Eine ausführliche API-Dokumentation finden Sie in der MCP-Protokollspezifikation .

Für Entwickler

Installation

# Using npm
npm install

# Using pnpm
pnpm install

Ausführen eines Builds

# Using npm
npm run build

# Using pnpm
pnpm build

Integration mit Claude Desktop

Um Ihren Xero MCP-Server in der Entwicklung mit Claude Desktop zu verknüpfen, gehen Sie zu Einstellungen > Entwickler > Konfiguration bearbeiten und fügen Sie Folgendes zu Ihrer Datei claude_desktop_config.json hinzu:

HINWEIS: Stellen Sie unter Windows sicher, dass der args das \ zwischen den Ordnern vermeidet, d. h. "C:\\projects\xero-mcp-server\\dist\\index.js"

{
  "mcpServers": {
    "xero": {
      "command": "node",
      "args": ["insert-your-file-path-here/xero-mcp-server/dist/index.js"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Lizenz

MIT

Sicherheit

Bitte übergeben Sie Ihre .env Datei oder vertrauliche Anmeldeinformationen nicht der Versionskontrolle (sie sind als sicherer Standard in .gitignore enthalten).

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Eine Model Context Protocol-Serverimplementierung, die standardisierten Zugriff auf die Buchhaltungs- und Geschäftsfunktionen von Xero bietet und Vorgänge wie Kontaktverwaltung, Rechnungserstellung und Kontenplanverwaltung über MCP ermöglicht.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Xano MCP Server
SarimSiddd
A
security
F
license
A
quality
Enables interaction with the Xano API through a Model Context Protocol (MCP) interface, providing secure and type-safe management of Xano database operations.
Last updated -
6
TypeScript
ABAP-ADT-API MCP-Server
mario-andreschak
A
security
A
license
A
quality
A Model Context Protocol server that facilitates communication between ABAP systems and MCP clients, providing tools for managing ABAP objects, handling transport requests, and performing code analysis to enhance ABAP development workflows.
Last updated -
128
40
TypeScript
MIT License
Xero MCP Server
john-zhang-dev
-
security
A
license
-
quality
An MCP server allowing Clients to interact with Xero Accounting Software
Last updated -
672
17
TypeScript
MIT License
Marketo MCP Server
alexleventer
A
security
F
license
A
quality
A Model Context Protocol server for interacting with the Marketo API that provides tools for managing Marketo forms, including listing, cloning, and approving forms.
Last updated -
4
2
TypeScript

View all related MCP servers

Xero MCP Server