Thred

Xero MCP server: what it does in Claude, can it reconcile, and the risks

Manoj Tutika · Published 16 November 2026 · Last checked 16 November 2026

Working on this yourself? Talk to Mark, our co-founder. We’re here to solve it with you.

Book a demo

Is there a Xero MCP server?

Yes. Xero publishes an open-source MCP server on GitHub (XeroAPI/xero-mcp-server), and since May 2026 it also offers a hosted Xero connector inside Claude. They are two different things, and the difference decides what Claude can do with your books. The connector is the easy route and it is read-only. The GitHub server runs on your own machine, needs a developer setup, and can create and update records. This guide covers what each one does as of 16 November 2026, whether either can reconcile, and where the risk sits.

If you want the general picture of connecting an AI assistant to a ledger, read how to connect Claude or ChatGPT to your accounting system first. For what Claude is good at in finance work beyond Xero, see Claude for finance teams. This page stays on Xero.

What is the difference between the Xero connector and the Xero MCP server?

Xero's two routes into Claude (checked 16 November 2026)
QuestionXero connector for ClaudeXero MCP server (GitHub)
Where it runsHosted, added from Claude's connectors directoryLocally, started with npx on your computer
SetupSign in with your Xero login, pick an organisationCreate a Xero developer app, add credentials to Claude Desktop's config file
Reads dataYes, live profit, cash, invoices, customersYes, accounts, contacts, invoices, bank transactions, reports, payroll
Writes dataNo, Xero says it can't create, edit, approve, reconcile or payYes, create and update tools for invoices, contacts, journals, payments and more
DeletesNoOnly payroll timesheets
Reconciles bank linesNoNo reconcile tool
Several organisationsSwitch between organisations and clientsOne organisation per custom connection
CostFree to add, needs an active Xero subscriptionFree code, but a Xero developer connection is needed

What tools does the Xero MCP server expose?

The README on GitHub lists the tools by verb. The read tools include list-accounts, list-contacts, list-invoices, list-bank-transactions, list-manual-journals, list-payments, list-trial-balance, list-profit-and-loss, list-report-balance-sheet, list-aged-receivables-by-contact, list-aged-payables-by-contact and list-tracking-categories, plus a set of payroll list tools. Payroll queries only work for UK and NZ organisations.

The write tools are where it gets interesting for a finance team: create-invoice, create-credit-note, create-contact, create-manual-journal, create-payment, create-bank-transaction and create-quote, with matching update tools. Updates to invoices, quotes and credit notes only work on drafts. There is no general delete tool. The only delete is delete-payroll-timesheet.

How do you connect the Xero MCP server to Claude?

Xero's README describes two authentication modes. A custom connection uses a client ID and secret for one organisation and is the mode it recommends for Claude Desktop. A bearer token mode suits tools that handle the sign-in flow themselves and switch between several organisations at runtime.

  1. Create a custom connection app in your Xero developer account for the organisation you want Claude to see, and add every scope the README lists.
  2. Copy the client ID and client secret.
  3. In Claude Desktop, open Settings, then Developer, then Edit config.
  4. Add an mcpServers entry that runs npx with the package @xeroapi/xero-mcp-server@latest, and put XERO_CLIENT_ID and XERO_CLIENT_SECRET in its env block.
  5. Restart Claude Desktop and test against the Xero Demo Company before you point it at real books. Xero recommends the demo company for getting started.

You need Node.js 18 or later. Keep the credentials out of shared drives and version control. Note one dated change: Xero's developer FAQ says that from 1 December 2026 you can no longer create a new custom connection app or buy a new custom connection subscription. Existing ones keep working. Each custom connection connects to a single organisation only.

If you only want to ask questions, skip all of this and add the hosted Xero connector from Claude's connectors directory. Xero says there is no developer setup, and that it works on free and paid Claude plans.

Can Claude reconcile Xero?

Not in the sense an accountant means. The hosted connector is read-only by design, and Xero states it cannot reconcile. The GitHub server can create and update bank transactions (spend and receive money), but it has no tool to match a bank statement line to an existing invoice or bill. Creating a new spend money transaction for a line that should have matched an invoice is how you end up with duplicates and an inflated purchase ledger.

What Claude can do well is the thinking around reconciliation. Pull unreconciled bank transactions, compare them with open invoices and aged payables, and give you a list of likely matches to click through in Xero. For rules that handle the repetitive lines, see Xero bank rules.

What are the risks of giving Claude write access to Xero?

The local server writes as soon as Claude decides to call a create tool. Claude Desktop asks you to allow tool calls, but there is no accounting control in between: no rule about which accounts it may post to, no limit per amount, no second reviewer.

  • Wrong period. A manual journal dated in last month changes numbers you already reported. A Xero lock date stops this, see year end and lock dates in Xero.
  • Wrong organisation. Practices with many clients need one custom connection per organisation, and it is easy to ask the wrong one.
  • No audit narrative. Xero records the API user, not the reason. Your team still has to explain why an entry exists.
  • Credentials on a laptop. The client secret sits in a local config file.

Practical rules: start read-only, test writes on the demo company, keep drafts as drafts so a person approves in Xero, and never give an assistant a connection to payroll unless that is the job.

How is Thred different from the Xero MCP server?

The MCP server is a toolbox. Thred is a team that already knows the finance job. Thred's agent works on Xero through the Xero API, reads and writes, and treats every write as something a person signs off.

  • Approval cards. Every create or update is shown as a card with the account, amount, VAT and source before it reaches Xero. You accept it, edit it, or set a rule to accept that kind of entry from then on.
  • Rules you set. Per client read-only mode, write only after approval, or accept a named kind of entry automatically.
  • One chat across clients. Accounting firms ask about any client in one conversation and Thred picks the right organisation, with the client name on every approval card.
  • Work that runs without being asked. Checks and close steps run on a schedule across every client, not only when someone types a prompt.

What do Thred's agents do on Xero?

Thred puts a full finance team of agents on the Xero file you already have. The Bookkeeper keeps the record up to date, coding lines and spotting duplicates. The Collector manages your receivables, The Payer manages your payables. The Accountant handles filings and optimises for taxes, The Treasurer manages your cash and The Analyst monitors performance and variance. The Connector finds context in your connected tools, from email to document stores, and The CFO is your finance lead when you have none. Each one proposes, you approve, and the books stay in Xero. See Thred Layer or book a demo.

Frequently asked questions

Is there a Xero MCP server?

Yes. Xero maintains an open-source MCP server at github.com/XeroAPI/xero-mcp-server that runs locally through npx. Since May 2026 Xero also offers a hosted, read-only connector you add from Claude's connectors directory.

Does Xero have MCP for ChatGPT?

Xero's own pages describe the hosted connector for Claude. The GitHub server follows the open MCP standard, so any MCP client that supports local servers can run it. Check your ChatGPT plan's support for custom MCP connectors before relying on it.

Can Claude reconcile Xero?

No. Xero says its Claude connector cannot reconcile, and the GitHub MCP server has no tool that matches a statement line to an invoice or bill. Claude can list unreconciled lines and suggest matches for you to confirm in Xero.

Can the Xero MCP server create invoices?

Yes. It has create-invoice and update-invoice tools, among others. Updates to invoices, quotes and credit notes only work while they are drafts.

What is a Xero custom connection?

A Xero developer app linked to a single organisation, authenticated with a client ID and secret. Xero's developer FAQ says no new custom connections can be created or bought from 1 December 2026; existing ones keep working.

Is the Xero connector for Claude free?

Xero says the connector is free to add. You need an active Xero subscription and a Claude account on a free or paid plan.

Is it safe to give Claude write access to Xero?

Only with controls around it. Test on the Xero Demo Company, set lock dates for closed periods, keep entries as drafts for a person to approve, and use one connection per organisation so Claude cannot write to the wrong client.

Sources

  1. XeroAPI/xero-mcp-server README (GitHub)
  2. Xero: Get clear answers on your Xero finances from Claude
  3. Xero media release: Xero delivers Claude integration (13 May 2026)
  4. Xero Developer FAQ: Custom Integration (custom connection changes from 1 December 2026)

Read next

Where Thred comes in

Thred Layer

Finance agents running on top of your existing ledger. You set the rules, approve the work and handle the exceptions. No migration.

Finance, handled.

Book a demo, or request a callback and we will call you.

Book a demo