Skip to content
The AR AgentThe accounts receivable agent
Log in

Xero MCP: connect Xero to Claude or ChatGPT

By The AR Agent team · · 7 min read

A Xero MCP server lets an AI assistant such as Claude or ChatGPT read from Xero, and in some cases write to it, so you can ask about invoices and contacts in plain words. MCP is the Model Context Protocol, an open standard for connecting assistants to software. Xero publishes its own server, and it also hosts one.

This page covers what Xero's own servers do, what to check before you connect one, and what to ask once it is running. It is written for a small business owner or finance lead who wants to know who owes them money, not for a developer building an app.

What is a Xero MCP server?

An MCP server is a small program that offers an assistant a set of tools, such as "list invoices" or "create a contact". The assistant decides which tool to call from what you ask, and answers from what comes back. Without one, the assistant knows only what you paste in.

For Xero there are three routes. Each suits a different person.

Xero's open-source server. Xero's GitHub README describes it as an MCP server implementation for Xero. It needs Node.js 18 or higher and a Xero developer account with API credentials. It suits someone comfortable editing a configuration file.

Xero's hosted server. Xero's developer site describes a Xero-hosted remote MCP server and links to setup guidance for Claude. The page is aimed at developers building AI apps and agents. It does not say what the server can and cannot do, so read Xero's current documentation before you rely on it.

A hosted connector built for one job. These run on the provider's servers, offer fewer tools chosen for that job, and need only a sign-in. The AR Agent's connector is one, built for receivables.

What can the open-source Xero MCP server do?

Going by the tools its README lists:

  • Read: accounts, contacts, credit notes, invoices, payments, quotes, tax rates, bank transactions, organisation details, profit and loss, balance sheet, trial balance, and aged receivables and payables by contact. It also lists payroll tools, which its README says work only for the NZ or UK region.
  • Create: invoices, contacts, credit notes, payments, quotes, manual journals, bank transactions and more.
  • Update: contacts, items, manual journals and bank transactions among others. Invoices, quotes and credit notes can be updated only while they are drafts.

Read the list yourself before you connect, because it changes. The point is that a server like this can do more than answer questions. Ask it to "sort out the [Customer] account" and it may have the tools to create a payment. That is useful for a bookkeeper who wants it, and a risk for anyone who does not.

How do you set up the Xero MCP server?

In outline, for the open-source server:

  1. Create an app in the Xero developer portal. Its README describes a custom connection, which it recommends for testing and for clients such as Claude Desktop, using a client ID and client secret.
  2. Add an entry to your assistant's configuration that runs the server with npx, and put the credentials in that entry. Never commit those credentials to a code repository.
  3. Connect it to the Demo Company first and try a few questions.
  4. Only then point it at your real organisation.

Xero has changed the scopes a custom connection needs, and its README says the requirements depend on when the connection was created. If a tool fails with a permissions error, that is the first place to look.

What should you check before you connect Xero?

Use these on any server, local or hosted.

  1. Can it write? List the tools and look for ones that create, update or delete.
  2. Is there an approval step? If it can act, does anything wait for a person before it reaches a customer or your ledger?
  3. Where do the credentials live? A local server holds your keys on your computer. A hosted one holds a token on its servers. Know how to revoke either.
  4. What does the assistant's provider receive? Whatever the assistant reads is handled under that provider's terms. Check them against your company's rules, particularly with customer data.
  5. How do you disconnect? You should be able to remove it from the assistant and revoke access in Xero.

What should you ask about overdue invoices?

Once Xero is connected, the useful questions are the ones you would otherwise answer with a report and your inbox side by side.

  • Who owes me money, and how late is each invoice?
  • Which customers have more than one overdue invoice?
  • What is the total overdue for [Customer]?

A server that reads Xero answers these from the ledger. It cannot answer the questions that matter more: why has [Customer] not paid, what did they last say, and who promised to pay this week. That conversation lives in your inbox, not in Xero. For the background, see our pages on ChatGPT with Xero or QuickBooks and Claude for accounting.

Our view

We make The AR Agent, so weigh this accordingly. A finance lead who looks after several clients told us the dashboards they had tried showed ageing and cash collected, and gave the person chasing nothing to act on. A general Xero server has the same limit. It tells you an invoice is 40 days late. It does not know the customer replied last Tuesday to say the purchase order number was wrong.

Most late payment is an operational problem showing up in collections: a missing or closed PO, a dispute over what was delivered, an invoice stuck in approval at the customer's end. Those are fixed by a person talking to sales or operations, and they are recorded in email threads. We think a connector for chasing should be judged on whether it can read that history, and on how little it can change. Broad write access to your ledger is a feature for a bookkeeper. It is not a feature for chasing.

Frequently asked questions

Is there an official Xero MCP server?

Yes. Xero publishes an open-source server at github.com/XeroAPI/xero-mcp-server, and its developer site describes a Xero-hosted remote MCP server. Check Xero's current documentation, as both change.

Do I need to know how to code to use it?

For the open-source server, you need to be comfortable with developer credentials and a configuration file, and to have Node.js installed. A hosted connector built for one job needs only a sign-in.

Can a Xero MCP server change my books?

The open-source server's README lists tools that create invoices, contacts and payments and tools that update records, so yes. Check the tool list of any server you use. The AR Agent connector reads and drafts, and it cannot change anything in Xero.

Can it chase my overdue invoices?

A general Xero server can tell you which invoices are overdue and could be asked to draft a reminder. It does not keep track of customer replies, payment promises or what is blocking payment. A connector built for collections does.

Does it work with both Claude and ChatGPT?

MCP is an open standard, so a server can work with either, but each assistant has its own way of adding one. In Claude they are called connectors. In ChatGPT they appear as apps and plugins.

How The AR Agent handles this

The AR Agent chases overdue invoices for small businesses. It connects to Xero or QuickBooks and your inbox, follows up each overdue invoice by email, reads replies and tracks what customers promise. Its connector for Claude and ChatGPT lets you ask about that work in plain words: who owes you, why a customer has not paid, who promised to pay this week. Ask it to chase someone and the draft waits in the app for your approval. It cannot send email or change anything in Xero. See how it works with ChatGPT.

Talk to us: our AI agent chases your invoices until you are paid.

Sources

Let us chase your overdue invoices

Connect QuickBooks or Xero and your finance inbox. We’ll help you set it up. No card or contract.

Accounting software

No card required.