Claude Skills for Xero: how to connect, and what it can do once it is there

Contents

There are three ways to get Xero data into Claude: the official Xero connector (read-only, free, connect it in your AI app's connector settings), the Xero MCP server (read and write, needs a paid Custom Connection at roughly 5 to 10 US dollars per organisation per month), and a CSV export from the Xero screen (no connection at all, works everywhere). Once connected, a skill can produce aged receivables, DSO, late fee schedules, statements and chase drafts. It cannot send an email, because Xero exposes no send tool.

That last sentence is the one that surprises people, so it is worth stating up front rather than after you have paid for a connection.

Free and open source
Denymbird / accounts-receivable-skills

Our receivables skill for Xero, in the open. It reads all three routes below: the Xero connector, the MCP server, or a plain CSV export. Aged receivables, DSO, late fee schedules, statements and chase briefs, every figure computed by a bundled script rather than by the model.

  • MIT licence
  • Python, nothing to install
  • 59 tests
  • Works on the Xero Demo Company
Get the skill on GitHub

Works in Claude, Claude Code, Codex and Cursor. Setup for each route is in the repository.

Details below are correct as at August 2026. Xero has moved quickly in this area, so verify pricing and regional availability on Xero's AI toolkit page before you commit to an approach.

The three connection routes

RouteReadWriteCostBest for
CSV exportYesNoFreeAnyone, any country, many clients
Xero connectorYesNoFreeOne organisation, fastest setup
Xero MCP serverYesYesPaid, per organisationRaising fee invoices and credit notes

Route A: CSV export, five minutes, no setup

Start here if you are unsure. It needs no developer account, no subscription and no permissions conversation with a client.

  1. In Xero, go to Business, then Invoices, then the Awaiting Payment tab.
  2. Select all, then Export. Xero writes an Invoices.csv file.
  3. Repeat on the Paid tab if you want payment history as well, which the skill uses for average days to pay.
  4. Put both files in a folder and point the skill at them.

The Accounting, Reports, Aged Receivables Detail report exports the same way if you prefer the report format.

This route has an advantage the connectors do not: it is the only one that handles many organisations in a single run. Every connector holds one company at a time, so a bookkeeper with a book of clients exports once per client into one folder each and processes the lot. Ten minutes of exporting replaces a morning of reviews.

It also keeps the data scope tight. You are handing over one aged receivables file, not access to the entire ledger, which is a materially easier conversation with a client who is nervous about AI.

Route B: the Xero connector, read-only

Xero published an official connector in May 2026. You connect it in your AI app's connector settings, sign in to Xero, and start asking questions.

It is genuinely quick, and it is read-only. You can ask for receivables, top customers by overdue amount, and the state of the ledger. You cannot change anything through it, which for most people is the correct setting anyway.

The constraint to plan around is that it connects to one organisation. To look at a different company you disconnect and reconnect.

Route C: the Xero MCP server, read and write

The official Xero MCP server runs locally and exposes around fifty tools. This is the route you need if you want the AI to create a late fee invoice or a credit note rather than just tell you about one.

Authentication is the friction. You need either a Xero Custom Connection, which is a paid add-on of roughly 5 to 10 US dollars per organisation per month and is available to organisations in Australia, New Zealand, the United Kingdom and the United States, or your own OAuth bearer token, which means managing token refresh yourself. It is free against the Xero Demo Company, so you can test the whole workflow before paying for anything.

What the Xero connection cannot do

Four limits shape what a sensible skill does. None of them are dealbreakers, but designing around them beats discovering them.

There is no email tool. Xero's API can email an invoice, but the MCP server does not expose it and the connector is read-only. Every chase email and statement is a draft that a person sends.

Ageing is per contact. The aged receivables tool requires a contact ID, so there is no single call that returns the whole book. A skill either loops every contact or, more sensibly, pulls the invoice list once and calculates the ageing itself.

The invoice list is not filterable. It returns ten records a page and takes no status or due-date filter, so you page through everything and filter locally.

The rate limit is real. Sixty calls a minute and five thousand a day per organisation. A five hundred invoice ledger is fifty calls just to read it. Pull once into a local snapshot and work from that file rather than re-querying for every question.

Do not let the model add up your ledger

Whichever route you choose, the arithmetic must happen in code. Language models are unreliable at totalling a hundred numbers and the failure is silent: the figure looks right and is out by a few hundred pounds. A skill worth using runs a script for every total, ageing bucket and fee, and shows the workings so you can check them.

What it can do once connected

With the ledger readable, the receivables jobs a skill handles well are the recurring ones.

  • Debtor review. Aged receivables by customer, the buckets, the movement since the last run, and the accounts that deteriorated.
  • DSO and payment behaviour. Days sales outstanding, average days to pay, and which customers are dragging the average out.
  • Late fee schedules. Which invoices have passed terms, what your contract allows on each, and the calculation behind every line.
  • Statements. Neither Xero nor QuickBooks exposes statements through their API, so a good skill builds the statement itself from open invoices and payments.
  • Chase drafts. One email per customer at the right escalation level, with the amounts copied from the ledger rather than recalled.
  • Call priority. Who to ring today, ranked by amount, age and how that customer has paid historically.

Our own skill for this is open source and MIT licensed: accounts-receivable-skills on GitHub. It supports all three routes above, computes every figure in a bundled Python script with nothing to install, and ships 59 tests against a fixture ledger so you can verify the arithmetic yourself. The wider guide to Claude Skills for accountants covers what skills are and how they differ from MCP servers, and there is a parallel guide for QuickBooks Online.

Late fees on Xero need a separate invoice

This one catches people out. Xero does not let you add lines to an approved invoice, so you cannot bolt a fee onto the original debt.

Raise the fee as its own invoice instead. That is the correct mechanic on Xero, and it is also better practice: the customer can query, pay or have the fee credited without anyone touching the invoice underneath it.

Late fees are leverage. An invoice that grows is an invoice that moves up the payment run, and the reminder that a fee applies does more work than the fee itself. The condition is that you apply it consistently. A fee you announce and never charge teaches customers your terms are optional. Whatever rate you set has to be in the contract to be enforceable, so check your terms of trade before you quote a figure to a client.

The gap the connection leaves open

Everything above happens when a person asks. That is the shape of the whole category right now: no Xero connection can trigger on an overdue invoice, so nothing runs unless someone opens the ledger and starts a session.

A weekly review is always somewhere between one and seven days late. The invoice that went past terms on Saturday sits there until Monday, and the fee your contract allows is not applied because nobody was in the room.

💡 Paidnice insight

We publish an AI skill and we still run the chasing through automation, because they solve different halves of the problem. The skill answers the question when you ask it. Automation applies the same policy to every invoice on the day it lapses, which is where the result actually comes from. Customers cut their average wait for payment in half within 30 days, and none of that depends on remembering to run a report.

If you want the policy to run itself on your Xero ledger, that is what Paidnice for Xero does: reminders on schedule, late fees applied under your own rules, statements that go out without a trigger, and escalation that happens whether or not anyone looked that morning.

Common questions

Is there a Claude connector for Xero?

Yes. Xero published an official read-only connector in May 2026, which you enable in your AI app's connector settings. For write access you need the Xero MCP server with a Custom Connection instead.

Does the Xero MCP server cost money?

The server is free and open source. The Custom Connection it usually authenticates with is a paid Xero add-on, roughly 5 to 10 US dollars per organisation per month, currently for Australian, New Zealand, United Kingdom and United States organisations. It is free against the Xero Demo Company.

Can Claude send invoice reminders from Xero?

No. There is no email tool in either the connector or the MCP server, so reminders and statements are drafts a person sends. Automated sending needs software that connects to Xero directly.

Can I connect more than one Xero organisation?

Not through a connector, which holds one organisation at a time. For a book of clients, export a CSV per client and run the skill across the folders.

Is it safe to give an AI access to my Xero account?

The read-only connector cannot change your data, which removes most of the risk. If you want a tighter scope than that, the CSV route means handing over one receivables export rather than the whole ledger. Whatever route you take, treat anything the AI drafts as a draft, and never let it send or post without review.

Denym Bird

Written by

Denym Bird

Co-founder & CEO of Paidnice

Denym is a software entrepreneur and writes about accounts receivables management for small business.

Stop chasing invoices.
Start getting paid.

Paidnice takes the pain out of getting paid for thousands of businesses using Xero and QuickBooks.

Try it Now - It's Free

No card required.

ACAcme Joinery 12 days overdue Checking policy Late fee applied Awaiting payment $4,120 $4,202
BRBrightwork Due today Reminder sent Still unpaid Final notice $1,880
CVCoverdale Due in 3 days Reminder sent Checking policy Exempt from fees Needs review Sent to your team $6,480

Try Our Free Accounts Receivable Calculators

Optimize your cash flow with our suite of financial tools designed for AR professionals. Calculate DSO, aging analysis, late fees, and more.

Explore Calculators