Serveur Xero Mcp

Créé par

XeroAPI•Jul 7, 2025

Un serveur MCP qui s'intègre avec le protocole MCP. https://modelcontextprotocol.io/introduction

Aperçu

Qu'est-ce que xero-mcp-server ?

Le ### xero-mcp-server est une implémentation d'un serveur qui s'intègre avec le Protocole de Contexte de Modèle (MCP). Ce serveur permet aux développeurs de créer des applications capables de communiquer efficacement en utilisant le MCP, facilitant l'échange de données et l'interaction entre différents systèmes. Le MCP est conçu pour fournir un moyen standardisé pour les applications de partager le contexte et les données, rendant plus facile le développement de services interconnectés.

Caractéristiques de xero-mcp-server

Intégration avec MCP : Le serveur est conçu pour s'intégrer parfaitement avec le Protocole de Contexte de Modèle, garantissant compatibilité et facilité d'utilisation pour les développeurs.
Répertoire Public : Le xero-mcp-server est disponible en tant que répertoire public, permettant aux développeurs d'accéder au code source, de contribuer et de collaborer sur les améliorations.
Licence MIT : Le projet est sous licence MIT, ce qui permet une utilisation, une modification et une distribution gratuites du logiciel.
Communauté Active : Avec un nombre croissant d'étoiles et de forks, le xero-mcp-server a une communauté active qui contribue à son développement et à son support.

Comment utiliser xero-mcp-server

Cloner le Répertoire : Commencez par cloner le répertoire xero-mcp-server depuis GitHub sur votre machine locale en utilisant la commande :
```
git clone https://github.com/XeroAPI/xero-mcp-server.git
```
Installer les Dépendances : Naviguez jusqu'au répertoire du projet et installez les dépendances nécessaires. Cela implique généralement d'exécuter :
```
npm install
```
Lancer le Serveur : Après avoir installé les dépendances, vous pouvez démarrer le serveur avec :
```
npm start
```
Intégrer avec Votre Application : Utilisez l'API du serveur pour l'intégrer à votre application, en suivant la documentation fournie dans le répertoire.
Contribuer : Si vous souhaitez contribuer au projet, n'hésitez pas à forker le répertoire, à apporter vos modifications et à soumettre une demande de tirage.

Questions Fréquemment Posées

Qu'est-ce que le Protocole de Contexte de Modèle (MCP) ?

Le Protocole de Contexte de Modèle (MCP) est un protocole conçu pour faciliter le partage de contexte et de données entre les applications. Il fournit un moyen standardisé pour différents systèmes de communiquer, rendant plus facile le développement de services interconnectés.

xero-mcp-server est-il gratuit à utiliser ?

Oui, xero-mcp-server est sous licence MIT, ce qui permet une utilisation, une modification et une distribution gratuites.

Comment puis-je contribuer au projet xero-mcp-server ?

Vous pouvez contribuer en forkant le répertoire, en apportant vos modifications et en soumettant une demande de tirage. La communauté accueille les contributions qui améliorent la fonctionnalité et l'utilisabilité du serveur.

Où puis-je trouver la documentation pour xero-mcp-server ?

La documentation pour le xero-mcp-server se trouve généralement dans le fichier README du répertoire ou dans un dossier de documentation dédié au sein du répertoire.

Comment puis-je signaler des problèmes ou des bogues dans xero-mcp-server ?

Vous pouvez signaler des problèmes ou des bogues en naviguant vers la section "Issues" du répertoire GitHub de xero-mcp-server et en soumettant un nouveau problème avec des détails sur le problème que vous avez rencontré.

Détail

Xero MCP Server

This is a Model Context Protocol (MCP) server implementation for Xero. It provides a bridge between the MCP protocol and Xero's API, allowing for standardized access to Xero's accounting and business features.

Features

Xero OAuth2 authentication with custom connections
Contact management
Chart of Accounts management
Invoice creation and management
MCP protocol compliance

Prerequisites

Node.js (v18 or higher)
npm or pnpm
A Xero developer account with API credentials

Docs and Links

Setup

Create a Xero Account

If you don't already have a Xero account and organisation already, can create one by signing up here using the free trial.

We recommend using a Demo Company to start with because it comes with some pre-loaded sample data. Once you are logged in, switch to it by using the top left-hand dropdown and selecting "Demo Company". You can reset the data on a Demo Company, or change the country, at any time by using the top left-hand dropdown and navigating to My Xero.

NOTE: To use Payroll-specific queries, the region should be either NZ or UK.

Authentication

There are 2 modes of authentication supported in the Xero MCP server:

1. Custom Connections

This is a better choice for testing and development which allows you to specify client id and secrets for a specific organisation. It is also the recommended approach if you are integrating this into 3rd party MCP clients such as Claude Desktop.

Configuring your Xero Developer account

Set up a Custom Connection following these instructions: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

Currently the following scopes are required for all sessions: scopes

Integrating the MCP server with Claude Desktop

To add the MCP server to Claude go to Settings > Developer > Edit config and add the following to your claude_desktop_config.json file:

{
  "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"
      }
    }
  }
}

NOTE: If you are using Node Version Manager "command": "npx" section change it to be the full path to the executable, ie: your_home_directory/.nvm/versions/node/v22.14.0/bin/npx on Mac / Linux or "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx" on Windows

2. Bearer Token

This is a better choice if you are to support multiple Xero accounts at runtime and allow the MCP client to execute an auth flow (such as PKCE) as required. In this case, use the following configuration:

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

NOTE: The XERO_CLIENT_BEARER_TOKEN will take precedence over the XERO_CLIENT_ID if defined.

Available MCP Commands

list-accounts: Retrieve a list of accounts
list-contacts: Retrieve a list of contacts from Xero
list-credit-notes: Retrieve a list of credit notes
list-invoices: Retrieve a list of invoices
list-items: Retrieve a list of items
list-organisation-details: Retrieve details about an organisation
list-profit-and-loss: Retrieve a profit and loss report
list-quotes: Retrieve a list of quotes
list-tax-rates: Retrieve a list of tax rates
list-payments: Retrieve a list of payments
list-trial-balance: Retrieve a trial balance report
list-profit-and-loss: Retrieve a profit and loss report
list-bank-transactions: Retrieve a list of bank account transactions
list-payroll-employees: Retrieve a list of Payroll Employees
list-report-balance-sheet: Retrieve a balance sheet report
list-payroll-employee-leave: Retrieve a Payroll Employee's leave records
list-payroll-employee-leave-balances: Retrieve a Payroll Employee's leave balances
list-payroll-employee-leave-types: Retrieve a list of Payroll leave types
list-payroll-leave-periods: Retrieve a list of a Payroll Employee's leave periods
list-payroll-leave-types: Retrieve a list of all avaliable leave types in Xero Payroll
list-aged-receivables-by-contact: Retrieves aged receivables for a contact
list-aged-payables-by-contact: Retrieves aged payables for a contact
list-contact-groups: Retrieve a list of contact groups
create-contact: Create a new contact
create-credit-note: Create a new credit note
create-invoice: Create a new invoice
create-payment: Create a new payment
create-quote: Create a new quote
create-credit-note: Create a new credit note
create-payroll-timesheet: Create a new Payroll Timesheet
update-contact: Update an existing contact
update-invoice: Update an existing draft invoice
update-quote: Update an existing draft quote
update-credit-note: Update an existing draft credit note
update-payroll-timesheet-line: Update a line on an existing Payroll Timesheet
approve-payroll-timesheet: Approve a Payroll Timesheet
revert-payroll-timesheet: Revert an approved Payroll Timesheet
add-payroll-timesheet-line: Add new line on an existing Payroll Timesheet
delete-payroll-timesheet: Delete an existing Payroll Timesheet
get-payroll-timesheet: Retrieve an existing Payroll Timesheet

For detailed API documentation, please refer to the MCP Protocol Specification.

For Developers

Installation

### Using npm
npm install

### Using pnpm
pnpm install

Run a build

### Using npm
npm run build

### Using pnpm
pnpm build

Integrating with Claude Desktop

To link your Xero MCP server in development to Claude Desktop go to Settings > Developer > Edit config and add the following to your claude_desktop_config.json file:

NOTE: For Windows ensure the args path escapes the \ between folders ie. "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"
      }
    }
  }
}

License

MIT

Security

Please do not commit your .env file or any sensitive credentials to version control (it is included in .gitignore as a safe default.)

Configuration du serveur

{
  "mcpServers": {
    "xero-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/metorial/mcp-container--xeroapi--xero-mcp-server--xero-mcp-server",
        "node ./dist/index.js"
      ],
      "env": {
        "XERO_CLIENT_ID": "xero-client-id",
        "XERO_CLIENT_SECRET": "xero-client-secret"
      }
    }
  }
}

Infos du projet

Auteur

XeroAPI