hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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 サーバー

これはXero向けのモデルコンテキストプロトコル（MCP）サーバー実装です。MCPプロトコルとXeroのAPI間のブリッジを提供し、Xeroの会計機能とビジネス機能への標準化されたアクセスを可能にします。

特徴

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

前提条件

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

ドキュメントとリンク

設定

Xeroアカウントを作成する

Xero アカウントと組織をまだお持ちでない場合は、無料トライアルを使用してこちらからサインアップして作成できます。

デモ会社にはサンプルデータがあらかじめロードされているため、まずはデモ会社のご利用をお勧めします。ログイン後、左上のドロップダウンから「デモ会社」を選択してデモ会社に切り替えてください。デモ会社のデータは、左上のドロップダウンからMy Xeroにアクセスすることでいつでもリセットしたり、国を変更したりできます。

注意: 給与固有のクエリを使用するには、地域が NZ または UK のいずれかである必要があります。

認証

Xero MCP サーバーでは 2 つの認証モードがサポートされています。

1. カスタム接続

これは、特定の組織に対してクライアントIDとシークレットを指定できるため、テストや開発に適しています。また、Claude Desktopなどのサードパーティ製MCPクライアントに統合する場合にも推奨されるアプローチです。

Xero開発者アカウントの設定

次の手順に従ってカスタム接続を設定します: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

現在、すべてのセッションに次のスコープが必要です:スコープ

MCPサーバーとClaude Desktopの統合

MCP サーバーを Claude に追加するには、[設定] > [開発] > [構成の編集] に移動し、claude_desktop_config.json ファイルに次の内容を追加します。

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

注意: Node Version Managerを使用している場合は"command": "npx"セクションを実行可能ファイルへのフルパスに変更します。例: Mac / Linux の場合はyour_home_directory/.nvm/versions/node/v22.14.0/bin/npx 、Windows の場合は"your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx"

2. 無記名トークン

実行時に複数のXeroアカウントをサポートし、必要に応じてMCPクライアントが認証フロー（PKCEなど）を実行できるようにする場合は、こちらの方が適しています。この場合、以下の設定を使用してください。

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

注意: XERO_CLIENT_BEARER_TOKEN定義されている場合、 XERO_CLIENT_IDよりも優先されます。

利用可能なMCPコマンド

list-accounts : アカウントのリストを取得する
list-contacts : Xeroから連絡先リストを取得する
list-credit-notes : クレジットノートのリストを取得する
list-invoices : 請求書のリストを取得する
list-items : アイテムのリストを取得する
list-organisation-details : 組織の詳細を取得する
list-profit-and-loss : 損益レポートを取得する
list-quotes : 引用のリストを取得する
list-tax-rates : 税率のリストを取得する
list-payments : 支払いのリストを取得する
list-trial-balance : 試算表レポートを取得する
list-profit-and-loss : 損益レポートを取得する
list-bank-transactions : 銀行口座取引のリストを取得する
list-payroll-employees : 給与計算従業員のリストを取得する
list-report-balance-sheet : 貸借対照表レポートを取得する
list-payroll-employee-leave : 給与計算従業員の休暇記録を取得する
list-payroll-employee-leave-balances : 給与計算従業員の休暇残高を取得する
list-payroll-employee-leave-types : 給与計算の休暇の種類のリストを取得します。
list-payroll-leave-periods : 給与計算従業員の休暇期間のリストを取得します。
list-payroll-leave-types : Xero Payrollで利用可能なすべての休暇タイプのリストを取得します
list-aged-receivables-by-contact : 連絡先の経過年数の売掛金を取得します
list-aged-payables-by-contact : 連絡先の経過日数別の支払債務を取得します。
list-contact-groups : 連絡先グループのリストを取得する
create-contact : 新しい連絡先を作成する
create-credit-note : 新しいクレジットノートを作成する
create-invoice : 新しい請求書を作成する
create-payment : 新しい支払いを作成する
create-quote : 新しい引用を作成する
create-credit-note : 新しいクレジットノートを作成する
create-payroll-timesheet : 新しい給与計算タイムシートを作成する
update-contact : 既存の連絡先を更新する
update-invoice : 既存の請求書案を更新する
update-quote : 既存の見積書案を更新する
update-credit-note : 既存のドラフトクレジットノートを更新する
update-payroll-timesheet-line : 既存の給与計算タイムシートの行を更新する
approve-payroll-timesheet : 給与計算タイムシートを承認する
revert-payroll-timesheet : 承認された給与計算タイムシートを元に戻す
add-payroll-timesheet-line : 既存の給与計算タイムシートに新しい行を追加する
delete-payroll-timesheet : 既存の給与計算タイムシートを削除する
get-payroll-timesheet : 既存の給与計算タイムシートを取得する

詳細な API ドキュメントについては、 MCP プロトコル仕様を参照してください。

開発者向け

インストール

# Using npm
npm install

# Using pnpm
pnpm install

ビルドを実行する

# Using npm
npm run build

# Using pnpm
pnpm build

Claude Desktopとの統合

開発中の Xero MCP サーバーを Claude Desktop にリンクするには、[設定] > [開発者] > [構成の編集] に移動し、 claude_desktop_config.jsonファイルに次の内容を追加します。

注意: Windows の場合、 argsパスがフォルダー間の\をエスケープしていることを確認してください ( "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"
      }
    }
  }
}

ライセンス

マサチューセッツ工科大学

安全

.envファイルや機密性の高い資格情報をバージョン管理にコミットしないでください (安全なデフォルトとして.gitignoreに含まれています)。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Xero の会計およびビジネス機能への標準化されたアクセスを提供し、連絡先管理、請求書作成、MCP を介した勘定科目管理などの操作を可能にするモデルコンテキストプロトコルサーバーの実装。

Related Resources

Reddit Discussion about this server

Xero MCP Server