Xero

Xero MCP サーバー

これは、Xero 向けの Model Context Protocol（MCP）サーバー実装です。MCP プロトコルと Xero の API をつなぐブリッジを提供し、Xero の会計およびビジネス機能に標準化された方法でアクセスできるようにします。

来歴

このパッケージは、Xero のコミュニティ版 Xero MCP サーバーを Mindstone が保守しているビルドです。このサーバーは、Xero Developer Blog で発表され、XeroAPI/xero-mcp-server で開発されています。上流プロジェクトを基に、Mindstone による改善と強化を加えています。

ワンクリックインストール

ボタンをクリックすると、ホストから次の値を入力するよう求められます：XERO_CLIENT_ID、XERO_CLIENT_SECRET、XERO_CLIENT_BEARER_TOKEN。

{
  "mcpServers": {
    "Xero": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "",
        "XERO_CLIENT_SECRET": "",
        "XERO_CLIENT_BEARER_TOKEN": ""
      }
    }
  }
}

機能

• カスタム接続を使用した Xero OAuth2 認証
• 連絡先管理
• 勘定科目表の管理
• 請求書の作成と管理
• MCP プロトコルへの準拠

前提条件

• Node.js（v20 以降）
• npm または pnpm
• API 認証情報を持つ Xero 開発者アカウント

ドキュメントとリンク

• Xero Public API ドキュメント
• Xero API Explorer
• Xero OpenAPI 仕様
• Xero-Node Public API SDK ドキュメント
• 開発者向けドキュメント

セットアップ

Xero アカウントの作成

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

サンプルデータがあらかじめ用意されているため、最初は Demo Company を使うことをおすすめします。ログインしたら、左上のドロップダウンから「Demo Company」を選択して切り替えてください。左上のドロップダウンから My Xero に移動すると、Demo Company のデータをいつでもリセットしたり、国を変更したりできます。

注：給与関連のクエリを使用するには、リージョンを NZ または UK にする必要があります。

認証

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

1. カスタム接続

特定の組織のクライアント ID とシークレットを指定できるため、テストや開発に適した方式です。 Claude Desktop などのサードパーティ製 MCP クライアントに統合する場合にも、この方法をおすすめします。

Xero Developer アカウントの設定

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

現在、カスタム接続セッションには次のスコープが必要です：スコープ

MCP サーバーと Claude Desktop の連携

Claude に MCP サーバーを追加するには、Settings > Developer > Edit config に移動し、次の内容を claude_desktop_config.json ファイルに追加します。

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-xero@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. Bearer Token

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

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

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

利用可能な MCP コマンド

ツールの命名規則： このコネクターのツール名には、フォーク元から引き継いだ、接頭辞のないダッシュケース名（例：list-invoices、create-contact）が使われています。関連するコネクターでは、接頭辞付きのスネークケース名（例：list_quickbooks_invoices）が使われています。複数のサーバーをホストする環境では、接頭辞のない汎用的な名前が他のサーバーのツール名と衝突する場合があります。名前の変更は既存の設定との互換性を損なうため、現状のままにしています。ホストが名前空間の設定やエイリアスに対応している場合は、このサーバーで有効にすることをおすすめします。

• list-accounts：アカウントの一覧を取得します
• list-contacts：Xero から連絡先の一覧を取得します
• list-credit-notes：クレジットノートの一覧を取得します
• list-invoices：請求書の一覧を取得します
• list-items：項目の一覧を取得します
• list-organisation-details：組織の詳細を取得します
• list-profit-and-loss：損益レポートを取得します
• list-bank-summary：銀行概要レポート（口座ごとの残高と入出金）を取得します
• list-budget-summary：予算概要レポート（予算と実績）を取得します
• list-executive-summary：エグゼクティブサマリーレポート（主要な財務指標の概要）を取得します
• 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：連絡先グループの一覧を取得します
• list-currencies：接続中の Xero 組織で有効になっている通貨を取得します
• list-invoice-attachments：Xero の請求書に添付されたファイルを取得します
• list-purchase-orders：発注書の一覧を取得します
• create-contact：新しい連絡先を作成します
• create-credit-note：新しいクレジットノートを作成します
• create-invoice：新しい請求書を作成します。接続中の Xero 組織で有効になっている場合、USD などの任意の currencyCode を指定できます。
• create-payment：新しい支払いを作成します
• create-quote：新しい見積書を作成します
• create-purchase-order：新しい発注書を作成します
• create-credit-note：新しいクレジットノートを作成します
• create-payroll-timesheet：新しい給与計算用タイムシートを作成します
• update-contact：既存の連絡先を更新します
• update-invoice：既存の下書き請求書を更新します。接続中の Xero 組織で有効になっている場合、USD などの任意の currencyCode を指定できます。
• update-quote：既存の下書き見積書を更新します
• update-credit-note：既存の下書きクレジットノートを更新します
• get-invoice-history：請求書の履歴記録を取得します
• add-invoice-note：請求書の履歴に変更できないメモを追加します
• get-contact-history：連絡先の履歴記録を取得します
• add-contact-note：連絡先の履歴に変更できないメモを追加します
• get-credit-note-history：クレジットノートの履歴記録を取得します
• add-credit-note-note：クレジットノートの履歴に変更できないメモを追加します
• get-bank-transaction-history：銀行取引の履歴記録を取得します
• add-bank-transaction-note：銀行取引の履歴に変更できないメモを追加します
• get-quote-history：見積書の履歴記録を取得します
• add-quote-note：見積書の履歴に変更できないメモを追加します
• update-payroll-timesheet-line：既存の給与計算用タイムシートの明細行を更新します
• approve-payroll-timesheet：給与計算用タイムシートを承認します
• revert-payroll-timesheet：承認済みの給与計算用タイムシートを元に戻します
• add-payroll-timesheet-line：既存の給与計算用タイムシートに新しい明細行を追加します
• delete-payroll-timesheet：既存の給与計算用タイムシートを削除します
• get-payroll-timesheet：既存の給与計算用タイムシートを取得します
• email-invoice：承認済みの請求書のコピーを、関連する連絡先にメールで送信します 詳細な API ドキュメントについては、MCP Protocol Specificationを参照してください。

開発者向け

インストール

# Using npm
npm install

# Using pnpm
pnpm install

ビルドの実行

# Using npm
npm run build

# Using pnpm
pnpm build

Claude Desktop との統合

開発中の Xero MCP サーバーを Claude Desktop に接続するには、「Settings」>「Developer」>「Edit config」に移動し、以下を 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"
      }
    }
  }
}

ライセンス

MIT

セキュリティ

.env ファイルや機密性の高い認証情報をバージョン管理にコミットしないでください（安全のため、デフォルトで .gitignore に含まれています）。