Xero MCP

Xero + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するすべてのエージェント向け

非公式です。コミュニティが構築した、Xero API 用の Claude Code Skill および MCP サーバーです。Xero Limited とは提携しておらず、同社からの推奨や出資も受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されているすべてのコマンドは、実際の CLI に存在します。}

Xero Accounting のすべての読み取り機能に加え、ローカルの SQLite 台帳を利用できます。エイジング、照合、総勘定元帳（GL）の突合をオフラインで計算できるのは、ほかの Xero ツールにはありません。普段お使いの AI で利用できます。ChatGPT（Plus/Pro+。このコネクターの再公開までは一時停止中です。mcp-install.md を参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot のほか、リモート経由で Microsoft 365 Copilot / Copilot Studio と Google Gemini にも対応しています。無料、オープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されています。コードは不要です。

お使いのエージェントに対応

セキュリティに関する注意（このコネクターの再公開まで）。 HTTP モード （--transport http）は、localhost 上であっても実行しないでください。 このビルドにはパスワードがなく、すべてのネットワークインターフェイスで待ち受け、 ブラウザー再バインディング対策が導入される前のものです。そのため、開いたウェブページから 接続できてしまいます。また、MCP ツールは認証情報を使って変更を加えることもできます。 デフォルトの stdio トランスポートを使用してください。 リモートエージェント用にトンネルを設定している場合は、停止してください。 修正版は近日中に提供予定です。

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスですぐに利用可能）：

AI エージェント	Xero スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から xero-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターの再公開までは一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではそのモードにパスワードがなく、すべてのネットワークインターフェイスで待ち受け、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、servers キーの下にある mcp.json に xero-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、コネクターが再公開されるまでは一時停止中です。このビルドではそのモードにパスワードがなく、すべてのネットワークインターフェイスで待ち受け、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google の各スタックにも対応

多くのユーザーに利用されていますが、率直にお伝えすると、こちらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再発行されるまで一時停止しています。Copilot Studio では HTTP モードが必要ですが、このビルドの HTTP モードはパスワードなしで、すべてのネットワークインターフェースで待ち受け、開いた Web ページからアクセスできる設定になっています。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作するため、ChatGPT と同じく一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。インストール方法は以下の各セクションをご覧ください。また、MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの詳細な接続方法は、docs/which-agent.md をご覧ください。

複数のエージェントを使いますか？ 次のコマンドで、対応する51以上のエージェントすべてに一度にインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキルごとのインストーラーを実行してください）。docs/which-agent.md をご覧ください。

60秒でインストール

Claude Desktop で最も手早く使う方法 - ワンクリックの .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは、同梱の xero-cli を呼び出します。2026-09-18以降のリリースでは、この CLI がバンドル内に含まれています。それ以前のバンドルには MCP サーバーのみが含まれるため、同梱の CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを XERO_CLI_PATH に設定してください。詳細： #331。

Xero MCP をダウンロード（.mcpb） - ダウンロードしたら、Claude Desktop > Settings > Extensions を開き、ファイルを選択してください。ワンクリックで完了し、JSON もシェルも不要です。（すべての Xero リリースはリリースページで確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧の取得は不要で、すぐに使えます：

/plugin marketplace add Servosity/msp-skills
/plugin install xero@msp-skills

Path A - AI エージェントにプロンプトを1つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

このエージェントのワークスペースに、Servosity/msp-skills から Xero Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.ps1 | iex を実行してください。その後、README に従って認証し、xero-cli --help を実行して使い方を確認してください。

シェルを実行できるエージェントであれば、どれでも同じプロンプトを使えます。

Path B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.sh)

インストーラーは xero-cli（CLI）と xero-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じてスキルを検出します。

確認：

xero-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新のリリースを取得します。アップグレードするには、再度実行してください：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.ps1 | iex

Claude Desktop の .mcpb を使っている場合：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインを使っている場合：/plugin update xero@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md を参照してください。各エージェントのセクションがあり、GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot／Copilot Studio の接続方法も記載されています。最も簡単なのは Claude Desktop の Settings > Extensions パネルを使う方法です。JSON を編集したいユーザー向けの MCP 設定ブロックは mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/xero --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/xero --force

Hermes は MCP をネイティブにサポートしているため、xero-mcp サーバーを直接使用することもできます。インストール方法も環境変数も同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）：

https://github.com/servosity/msp-skills/tree/main/skills/xero から xero スキルをインストールしてください。このスキルでは、必須 CLI（xero-cli）を openclaw: フロントマターのブロックを使ってインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの接続設定はあらかじめ用意されており、OpenClaw の公開と同時に有効になります。

認証する

CLI に必要な2つの認証情報を設定します。OAuth2 アクセストークン（Xero developer portal で Custom Connection を作成して発行）と、組織のテナント ID です：

XERO_ACCESS_TOKEN=<value> XERO_TENANT_ID=<value> xero-cli doctor

doctor は、データにアクセスする操作を実行する前に、認証情報が有効かどうかを確認します。認証情報が拒否された場合も終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく寄せられる質問	コマンド
未払いの取引先は誰で、各請求書の支払期限はどれくらい過ぎていますか？	xero-cli aging --agent
仕入先への未払い額はいくらで、期間別ではどうなっていますか？	xero-cli aging --payable --agent
売掛金のリスクが最も高い連絡先はどれですか？	xero-cli exposure --agent
支払済みの金額が適用されていない、承認済みの請求書はどれですか？	xero-cli reconcile --agent
照合されていない銀行取引はどれで、何と一致する可能性がありますか？	xero-cli bank-recon --agent
決算時に GL の統制勘定と未払い請求書の金額は一致していますか？	xero-cli tie-out --agent
単一の勘定科目への転記内容を、残高の推移とともに確認できますか？	xero-cli ledger 200 --agent
先週から組織にどのような変更がありましたか？	xero-cli since 7d --agent
1回の呼び出しで組織の状態をまとめてください。	xero-cli snapshot --agent

コマンドの詳細については、guide.md を参照してください。AI エージェントの運用契約（--agent、--dry-run、データを変更する前に確認すべき状況）については、AGENTS.md を参照してください。

ほかとの違い

ほとんどの Xero 連携や MCP サーバーは、質問のたびにライブ API 呼び出しへ転送します。1件のレコードなら問題ありません。しかし、「承認済みの全請求書のうち、未払いの取引先は誰で、各請求書の支払期限はどれくらい過ぎているか」のような質問を大規模に行うと対応できず、そのために Xero のレート制限である1分あたり60回、1日あたり5,000回を消費してしまいます。

このスキルは、全文検索に対応したローカルの SQLite ミラーに Xero のデータを同期します。集計に関する質問は、ローカルの SQL 結合1回で即座に、オフラインでも処理でき、AI には生データではなく回答が表示されます。reconcile（承認済み請求書と適用済みの支払いをクロス結合）や tie-out（不変の仕訳帳の統制勘定と未払い請求書を比較）のような複合コマンドは、請求書、支払い、仕訳帳、勘定科目をまたいで結合します。これはステートレスな API ラッパーではできない処理です。

このスキルで解決できる課題

キャッシュフローは小規模なサービス業の事業を破綻させる要因であり、そのなかで最も時間のかかる作業が売掛金の回収です。r/msp や r/bookkeeping では、週次の売掛金督促や月末締めが手作業の儀式になっているという不満が繰り返し見られます。売掛金年齢表をエクスポートし、スプレッドシートに貼り付け、延滞日数ごとにピボット集計する頃には、督促リストはすでに1日遅れています。入金を承認済みの請求書に消し込み、未照合の銀行明細を決済対象の請求書に照合する作業は、1行ずつ画面を行き来しながらクリックする必要があります。さらに、これをスクリプトで処理しようとしても、Xero API の上限は毎分60回、1日5,000回であるため、本当に必要な複数エンドポイントをまたぐ結果を1回の呼び出しで取得することはできません。

このスキルは、組織のデータをローカルミラーに同期してから、オフラインで回答することで、この一連の作業を完結させます。

• xero-cli aging --agent - 今週の督促リストを延滞日数別に分類します（支払債務には --payable を指定します）。
• xero-cli exposure --agent - 売掛金リスクを取引先別に、延滞分の内訳とともに優先順位付けします。
• xero-cli reconcile --agent - 入金消し込みの差異を表示します。承認済みの請求書のうち、未払いで、消し込み済みの入金がないものを確認できます。
• xero-cli bank-recon --agent - 未照合の銀行明細を、該当する可能性の高い請求書や入金と照合します。
• xero-cli tie-out --agent - 締め時点で総勘定元帳の統制勘定と未決済の請求書が一致することを確認します。差異ゼロが一致の証拠です。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free プランではまだ Developer Mode を利用できません）が接続できるのは、HTTPS 経由のリモート MCP サーバーのみです。そのため、Xero MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはパスワードを要求せず、すべてのネットワークインターフェースで待ち受け、開いた Web ページからアクセスできるため、コネクターが再構築されるまでは実行したり、トンネルの背後に配置したりしないでください。その理由は mcp-install.md のセキュリティに関する注意事項で説明しています。それまでは、Claude Desktop、Claude Code、または Codex をお使いください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini で使えますか？

はい。どれも MCP に対応しています。ほかのツールへのインストールコマンドは上記の一覧と、docs/which-agent.md の詳細な解説をご覧ください。

コーディングの知識は必要ですか？

いいえ。推奨するインストール方法は、Claude Code または Codex に1文を貼り付けることです。エージェントが SKILL.md を読み取り、インストールを行います。代替方法として、OS ごとに1行のインストーラー（bash または PowerShell）を用意しています。どちらの方法でも、コードを書く必要はありません。Xero の認証情報を一度入力するだけです。

Xero のデータは安全ですか？

データはご自身のマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント配下のディレクトリに置かれます。AI エージェントが参照するのは CLI が返す内容だけで、通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills のリポジトリに含まれたり、外部に送信されたりすることはありません。

Xero API のレート制限に達しますか？

ほとんどありません。ローカルミラーに一度 sync すれば、売掛金年齢、照合、突合、エクスポージャー、元帳、検索はすべてオフラインで実行され、API 呼び出しはゼロです。API にアクセスするのは sync、明示的なライブ読み取り、書き込みのみです。Xero の上限は、組織ごとに毎分60回、1日5,000回です。ローカル優先の設計は、まさにこの上限を超えないためのものです。

どの Xero 認証情報が必要ですか？また、自動作成されますか？

Xero の開発者ポータルで OAuth2 トークンを発行します。マシン間での利用には Custom Connection が最も簡単です。次に、トークンと組織のテナント ID を XERO_ACCESS_TOKEN と XERO_TENANT_ID で渡します。CLI がトークンを作成またはローテーションすることはありません。渡されたトークンを使用するだけです。同期する前に xero-cli doctor を実行し、両方が設定されていることを確認してください。

1つの組織が対象ですか、それとも複数ですか？

XERO_TENANT_ID ごとに1つの組織です。ローカルミラーは1つのテナントを保持します。複数の法人を扱う場合は、テナント ID を各組織に順番に切り替えて実行してください。

Xero のウェブアプリを置き換えるものですか？

いいえ。編集や日々の記帳に引き続き使うポータルを補完するものです。このスキルは、滞留期間、照合、総勘定元帳の突合といった複数レポートにまたがる質問に、普段使用している AI エージェントでオフライン計算により回答するためのものです。

費用はかかりますか？

無料です。Apache-2.0 ライセンスで提供されています。費用が発生するのは使用する AI エージェント（Claude、ChatGPT、Codex など）のみで、その料金は当方ではなく AI プロバイダーから請求されます。

安全性モデル

Tier	例	推奨されるエージェントのポリシー
読み取り	aging、exposure、reconcile、bank-recon、tie-out、ledger、snapshot、since、search、sync、doctor、およびすべての get	許可
書き込み（定型）	invoices create、invoices update、contacts create、accounts create、payments create、bank-transactions create、items create、および一括の import	--dry-run でプレビューし、確認後に書き込む
破壊的操作／認証情報	accounts delete、items delete、payments delete、auth logout	必ず人間が関与

最も強力な制御は、Xero の認証情報に付与するスコープです。CLI で実行できるのは、認証情報で許可された操作のみです。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Xero API の仕様に対して検証済みで、毎週開催している Build Sessions で、本番テナントに対して実際に運用している MSP とともに検証を進めています。compoundingteams.com/build-sessions から参加をお申し込みください。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025年12月；40以上のエージェント）に準拠しています。MCP 互換で、Hermes を含む MCP 対応エージェントで動作します。OpenClaw 対応済み（フロントマターの設定済み、OpenClaw のリリース待ち）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスで提供されています。CLI Printing Press を使用して構築されています。最終更新日：2026-06-06。