mcp-xero

@codespar/mcp-xero

Xero 用 MCP サーバー — 中小企業向けのグローバルなクラウド会計サービスです。

Xero は世界第 2 位の中小企業向け ERP であり、英国、オーストラリア、ニュージーランドで業界をリードし、米国でも急速に拡大しています。QuickBooks と組み合わせると、この 2 つのプラットフォームで世界の中小企業会計の約 80％をカバーします。米国、英国、オーストラリア、ニュージーランドの顧客にサービスを提供する、または海外子会社を持つ中南米の SaaS 企業にとって、Xero はブラジルに根ざした ERP（Omie、Conta Azul、Bling、Tiny）を補完する重要なサービスです。

ツール（24）

ツール	用途
create_contact	Xero の連絡先（顧客またはサプライヤー）を作成します。Xero では、IsCustomer/IsSuppli... を持つ統一された Contact オブジェクトを使用します
get_contact	ContactID（UUID）で Xero の連絡先を 1 件取得します。
list_contacts	Xero の連絡先を一覧表示します。
create_invoice	Xero で請求書を作成します。
get_invoice	InvoiceID（UUID）または InvoiceNumber で請求書を 1 件取得します。
list_invoices	Xero の where 句による任意のフィルタリングを使用して、請求書を一覧表示します。
email_invoice	承認済みの請求書を、登録済みの連絡先のメールアドレスに送信します。
create_payment	請求書またはクレジットノートに対する支払いを記録します。
create_item	Xero の在庫／製品項目を作成します。
list_items	Xero テナントのすべての項目／製品を一覧表示します。
list_accounts	Xero の勘定科目表を一覧表示します。
update_contact	既存の Xero の連絡先を更新します。
archive_contact	ContactStatus=ARCHIVED に設定して、Xero の連絡先をアーカイブします。
update_invoice	既存の請求書を更新します。
void_invoice	Status=VOIDED に設定して、請求書を無効にします。
get_payment	PaymentID で支払いを 1 件取得します。
list_payments	Xero に記録された支払いを一覧表示します。
create_bank_transaction	銀行口座に直接、銀行取引（SPEND＝出金、RECEIVE＝入金）を作成します — 取引...
list_bank_transactions	銀行取引（銀行口座の支出／入金項目）を一覧表示します。
list_organisations	アクセストークンがアクセスできる Xero の組織を取得します — 名前、基本通貨、国、会...を返します
list_tax_rates	Xero テナントに設定されている税率を一覧表示します。
create_credit_note	クレジットノートを作成します。
list_credit_notes	クレジットノートを一覧表示します。
get_balance_sheet	テナントの貸借対照表レポートを取得します。

インストール

npm install @codespar/mcp-xero

環境

XERO_ACCESS_TOKEN="..."   # OAuth2 bearer access token (required, secret)
XERO_TENANT_ID="..."      # Xero tenant/organization id (required)

認証

Xero は OAuth2 を使用します。すべてのリクエストに以下が含まれます。

Authorization: Bearer <XERO_ACCESS_TOKEN>
Xero-tenant-id: <XERO_TENANT_ID>
Accept: application/json
Content-Type: application/json

このサーバーは、事前に発行されたアクセストークンを前提としています。OAuth の同意、リフレッシュトークンのローテーション、テナントの選択は、上流（OAuth プロキシまたはシークレットレイヤー）で行われます。トークンの有効期限が切れると、Xero は 401 を返し、ツールはエラーをそのまま表示します。トークンを更新して再試行してください。

実行

# stdio (default — Claude Desktop, Cursor, etc)
npx @codespar/mcp-xero

# HTTP (server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-xero

Where 句

Xero のリストエンドポイントは、サーバー側のフィルタリング用に where クエリパラメーターを受け付けます。例：

Name.Contains("ACME")
IsCustomer==true
Status=="AUTHORISED" AND Type=="ACCREC"
Date>=DateTime(2026,1,1)
Contact.ContactID==guid("00000000-0000-0000-0000-000000000000")

CodeSpar ERP カタログにおける位置付け

• ブラジルに根ざしたサービス： Omie、Conta Azul、Bling、Tiny — NF-e、Simples Nacional、現地の税務。
• グローバルな中小企業向け： Xero ＋ QuickBooks — 米国／英国／オーストラリア／ニュージーランド／グローバル会計。

ブラジル国外に本社を置く、または同地域で事業を展開する企業（もしくは海外法人を持つ企業）には Xero を使用してください。現地市場にはブラジルに根ざしたサーバーを使用してください。

ドキュメント

• Xero Accounting API: https://developer.xero.com/documentation/api/accounting
• Xero OAuth2 ガイド: https://developer.xero.com/documentation/guides/oauth2/overview

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT