Это реализация сервера Model Context Protocol (MCP) для Xero. Она обеспечивает мост между протоколом MCP и API Xero, обеспечивая стандартизированный доступ к бухгалтерским и бизнес-функциям Xero.

Особенности

• Аутентификация Xero OAuth2 с пользовательскими соединениями
• Управление контактами
• Схема управления счетами
• Создание и управление счетами
• Соответствие протоколу MCP

Предварительные требования

• Node.js (v18 или выше)
• NPM или PNPM
• Аккаунт разработчика Xero с учётными данными API

Документы и ссылки

• Документация Xero Public API
• Xero API Explorer
• Характеристики Xero OpenAPI
• Публичная документация SDK для Xero-Node
• Документация разработчика

Подготовка

Создать аккаунт Xero

Если у вас ещё нет аккаунта Xero и организации, вы можете создать его, зарегистрировавшись здесь с помощью бесплатного пробного периода.

Рекомендуем начать с Demo Company, так как она содержит заранее загруженные образцы данных. После входа переключитесь на неё, используя верхний левый выпадающий меню и выбрав «Demo Company». Вы можете сбросить данные Demo Company или сменить страну в любое время, используя выпадающее меню в левом верхнем углу и перейти в My Xero.

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

• Xero Public API Documentation
• Xero API Explorer
• Xero OpenAPI Specs
• Xero-Node Public API SDK Docs
• Developer Documentation

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/

Required Scopes

Custom connections require different scopes depending on when they were created. All scopes in the relevant list must be added to your custom connection:

Note: The MCP server automatically tries V1 scopes first and falls back to V2 if needed.

You can override these by setting the XERO_SCOPES environment variable to a space-separated list of 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",