Xero MCP Server

Official
MIT License
65
50
  • Apple
  • Linux

Integrations

  • Provides a bridge to Xero's accounting and business features, including contact management, chart of accounts management, and invoice creation and management, using OAuth2 authentication.

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

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).

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

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.

  1. Merkmale
    1. Voraussetzungen
      1. Dokumente und Links
        1. Aufstellen
          1. Erstellen Sie ein Xero-Konto
          2. Authentifizierung
          3. Verfügbare MCP-Befehle
        2. Für Entwickler
          1. Installation
          2. Ausführen eines Builds
          3. Integration mit Claude Desktop
        3. Lizenz
          1. Sicherheit

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol (MCP) server implementation that provides database interaction and business intelligence capabilities through SQLite. This server enables running SQL queries, analyzing business data, and automatically generating business insight memos.
              Last updated -
              6
              45,669
              JavaScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
              Last updated -
              3
              9
              36
              JavaScript
              Apache 2.0
            • -
              security
              A
              license
              -
              quality
              MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
              Last updated -
              4
              3
              TypeScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              An MCP server that exposes the XTB trading API, allowing users to interact with their XTB trading accounts through the Model Context Protocol to perform operations like account management, market data retrieval, and trade execution.
              Last updated -
              6
              TypeScript

            View all related MCP servers

            ID: 4rsnaczg6q