Xero MCP server
officialXero runs its own hosted MCP server, the Developer Remote MCP, which can read and write accounting data, and also maintains an open-source server that runs locally and covers contacts, invoices, payments, reports and payroll. A Xero connector in Claude's directory is also available and is read-only.
What an agent can do
- → Read profit and loss, balance sheet
- → List and create invoices
- → Manage contacts and chart of accounts
- → Record payments and bank transactions
- → Read payroll and timesheet data
The hosted server is included on the Core developer plan and above, does not work with Custom Connections and, according to Xero, does not ask for confirmation before changes. The local server can also write to the books and needs a Xero app with a custom connection per organisation.
About the Xero MCP server
Xero offers three ways for an AI assistant to reach the books, and all three come from Xero. The first is a read-only connector in Claude's directory. The second is the Developer Remote MCP, a server Xero hosts on api.xero.com for people building their own agents. The third is an open-source server that you run locally on your own machine.
Business owners and accounting practices use the connector to ask about profit, cash, invoices and customers and get answers that link to the report or invoice in Xero. Xero itself mentions weekly client briefings, quarterly reviews and checks for possible duplicate invoices. With the server's write tools, an agent can also create invoices, contacts, quotes, payments and manual journals.
The connector in Claude cannot create, edit, approve, reconcile or pay anything, and it follows your Xero permissions. The hosted server and the local one can write, and Xero points out that the version 1 tools do not ask for confirmation before a change. Tell the agent to check with you first. Calls count against the same daily limits as the Xero API.
Things to ask
- What does profit and loss look like for the last four quarters, and what changed the most?
- Who are our top five customers by revenue over the last twelve months?
- Are there invoices in the last 60 days with the same customer and amount that could be duplicates?
- List aged receivables by contact that are more than 30 days overdue.
- Create a draft invoice to Acme Ltd for 12 hours of advisory work and show it to me before saving.
Tools the server exposes
- list-invoices
- list-contacts
- list-accounts
- list-payments
- list-bank-transactions
- list-profit-and-loss
- list-report-balance-sheet
- list-trial-balance
- list-aged-receivables-by-contact
- list-aged-payables-by-contact
- list-quotes
- list-credit-notes
- list-organisation-details
- create-invoice
- update-invoice
- create-contact
- create-payment
- create-bank-transaction
- create-quote
- create-manual-journal
How to connect Xero
- If you only want answers in Claude: add Xero from Claude's connectors directory, sign in with your Xero login and choose the organisation. The connector is read-only.
- If you are building your own agent: create a Xero app that signs in with PKCE. The Developer Remote MCP is included on the Core plan and above. On Starter it only works with the demo organisation, and Custom Connections apps cannot use it.
- Add https://api.xero.com/mcp/v1 as a remote server in Claude Desktop, Claude Code, Cursor or VS Code and approve access for each organisation.
- If you prefer to run locally: start the package @xeroapi/xero-mcp-server with npx and enter the client ID and client secret from a Custom Connection. This needs Node.js 18 or later.
- Start with Xero's Demo Company, which comes with sample data, before you connect the real books.
Part of these packages
Xero is part of these Walma packages.
Questions about Xero MCP
Is Xero MCP free?+
The connector in Claude costs nothing extra: Xero does not charge for it, but you need an active Xero subscription, and a free or paid Claude account is enough. The Developer Remote MCP is included for apps on the Core developer plan and above, while Starter apps can only use the demo organisation. The local server is open source under the MIT licence.
What is the Xero MCP server URL?+
The hosted server, the Developer Remote MCP, is at https://api.xero.com/mcp/v1 and runs on Xero's own infrastructure. The open-source local server is available as the npm package @xeroapi/xero-mcp-server and at github.com/XeroAPI/xero-mcp-server. The connector in Claude needs no URL, it is added from Claude's directory.
How does sign-in work?+
The hosted server uses Xero OAuth 2.0 with PKCE, so no client secret is needed, and each organisation is approved through Xero's standard consent. Custom Connections apps are not eligible for the hosted server. The local server signs in with the client ID and client secret from a Custom Connection, or with a ready bearer token. The connector in Claude uses your normal Xero login.
Is Xero MCP read-only?+
It depends on which route you choose. The connector in Claude is read-only: Claude cannot create, edit, approve, reconcile or pay anything. The Developer Remote MCP and the local server can both read and write. Xero states that the version 1 tools do not ask the user to confirm changes, and advises telling the agent to confirm with you first.
Which AI assistants does Xero MCP work with?+
The read-only connector is made for Claude. For the hosted server Xero documents Claude Desktop, Claude Code, Cursor and VS Code, and says any client that supports remote MCP servers can connect, as long as the client can handle the OAuth sign-in. For the local server Xero describes the configuration in Claude Desktop.
What are the rate limits?+
The hosted server has the same limits as the Xero API: 1,000 calls per day per organisation for apps on Starter, and 5,000 per day per organisation on Core and above. API calls are logged under your app in the Developer Portal. Tool calls and prompts are not logged by Xero, so keep your own record if you need one.
Can one connection reach several Xero organisations?+
Yes, with the hosted server. One app can connect to several organisations when the user consents for each one, the agent can list them, and each tool call runs against a single organisation. In the Claude connector, access is limited to the connected organisation and data is not combined across organisations. Accountants and bookkeepers can switch between clients.
Missing a connection?
We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.