Xero MCP サーバー
これはXero向けのモデルコンテキストプロトコル（MCP）サーバー実装です。MCPプロトコルとXeroのAPI間のブリッジを提供し、Xeroの会計機能とビジネス機能への標準化されたアクセスを可能にします。
特徴
カスタム接続による Xero OAuth2 認証
連絡先管理
勘定科目管理
請求書の作成と管理
MCPプロトコル準拠
Related MCP server: ABAP-ADT-API MCP-Server
前提条件
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 ファイルに次の内容を追加します。
注意: 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など）を実行できるようにする場合は、こちらの方が適しています。この場合、以下の設定を使用してください。
注意: 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 プロトコル仕様を参照してください。
開発者向け
インストール
ビルドを実行する
Claude Desktopとの統合
開発中の Xero MCP サーバーを Claude Desktop にリンクするには、[設定] > [開発者] > [構成の編集] に移動し、 claude_desktop_config.jsonファイルに次の内容を追加します。
注意: Windows の場合、 argsパスがフォルダー間の\をエスケープしていることを確認してください ( "C:\\projects\xero-mcp-server\\dist\\index.js"
ライセンス
マサチューセッツ工科大学
安全
.envファイルや機密性の高い資格情報をバージョン管理にコミットしないでください (安全なデフォルトとして.gitignoreに含まれています)。