これはXero向けのモデルコンテキストプロトコル(MCP)サーバー実装です。MCPプロトコルとXeroのAPIをつなぐ橋渡しを提供し、Xeroの会計およびビジネス機能への標準化されたアクセスを可能にします。

特徴

• カスタム接続によるXero OAuth2認証
• コンタクト管理
• 勘定科目管理
• 請求書の作成と管理
• MCPプロトコル準拠

前提条件

• Node.js(v18以上)
• NPMまたはPNPM
• API認証情報を持つXero開発者アカウント

ドキュメントとリンク

• Xero公開APIドキュメント
• Xero API Explorer
• Xero OpenAPI仕様
• Xero-Node パブリックAPI SDKドキュメント
• 開発者ドキュメント

セットアップ

Xeroアカウントを作成

もしまだXeroのアカウントや組織を持っていない場合は、無料トライアルでこちらから登録して作成できます。

まずはデモ会社を使うことをおすすめします。なぜなら、サンプルデータが事前に読み込まれているからです。ログインしたら、左上のドロップダウンから「デモ会社」を選択して切り替えてください。デモ会社のデータをリセットしたり、国を変更したりするには、いつでも左上のドロップダウンから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",