---
title: "Xero MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/xero/
description: "TypeScript server bridging MCP to Xero's accounting API for contacts, chart of accounts and invoice management, distributed as the npm package @xeroapi/xero-mcp-server. Authenticates with OAuth2 custom connections or a bearer token, with scope sets that differ by connection creation date."
---

# Xero MCP Server: review, setup & limitations · Undominated.ai

> TypeScript server bridging MCP to Xero's accounting API for contacts, chart of accounts and invoice management, distributed as the npm package @xeroapi/xero-mcp-server. Authenticates with OAuth2 custom connections or a bearer token, with scope sets that differ by connection creation date.

[← Explore all mcp servers](/mcp-servers/)

ACCOUNTING OPERATIONS / Xero

# Xero MCP Server

TypeScript server bridging MCP to Xero's accounting API for contacts, chart of accounts and invoice management, distributed as the npm package @xeroapi/xero-mcp-server. Authenticates with OAuth2 custom connections or a bearer token, with scope sets that differ by connection creation date.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/XeroAPI/xero-mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 3 linked sources
 Publisher Xero
 Licence [MIT ↗](https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/LICENSE)
 Revision f24583c867df
 [Read what was—and wasn’t—checked ↓](#review)

“It provides a bridge between the MCP protocol and Xero's API, allowing for standardized access to Xero's accounting and business features.”

 [Xero · upstream description ↗](https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Xero publishes the server in its XeroAPI organisation; package.json names Xero as author and the LICENSE is MIT, Copyright (c) 2025 Xero Limited.
- Two documented authentication modes, OAuth2 custom connections for one organisation and a bearer token for several accounts at runtime, plus an XERO_SCOPES override, let a deployer set the access boundary.

### A good fit for

 - Managing contacts, chart of accounts and invoices in a Xero organisation from an MCP client.
- Developers testing against a Xero demo company before touching production accounting data.

### Weigh up before choosing

 - The README lists 51 commands, 25 of them writes: create-payment, create-invoice, create-manual-journal, create-bank-transaction, update-invoice, approve-payroll-timesheet and delete-payroll-timesheet among them. What runs is bounded only by the scopes granted to the connection or token.
- Required OAuth scopes differ for custom connections created before and after 29 April 2026, and several listed scopes are deprecated in favour of granular ones.
- The README says payroll queries need an NZ or UK region organisation.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md at f24583c867df7c1f4806f7532eb0691e85892865: features, prerequisites, both authentication modes with client configuration, scope tables for V1 and V2 custom connections, and the list of available MCP commands.
- package.json at the same revision: @xeroapi/xero-mcp-server 0.0.16, MIT licence, Xero authorship, bin entrypoint dist/index.js.
- LICENSE at the same revision: MIT License, Copyright (c) 2025 Xero Limited.

### Our findings

 - The server automatically tries V1 scopes first and falls back to V2, with XERO_SCOPES available as an override.
- A bearer token takes precedence over client credentials when defined, enabling multi-organisation runtime use.
- The README's command list has 25 list-* reads and get-payroll-timesheet, and 25 writes: 11 create-*, 10 update-*, add-payroll-timesheet-line, approve-payroll-timesheet, revert-payroll-timesheet and delete-payroll-timesheet.
- configExample is the README's Claude Desktop custom-connection block at this commit, placeholders and the optional XERO_SCOPES line included.
- Corrections: the earlier record gave package.json's version as 0.2.16 (it is 0.0.16), rewrote the config placeholders, and composed an install command the README does not print, so install.command is now null. A limitation based on the repository's last push date was a GitHub timestamp, not a file, and was dropped.
- Upstream health on 2026-10-13: XeroAPI/xero-mcp-server is not archived, its default-branch HEAD is this commit, the LICENSE is MIT and package.json names @xeroapi/xero-mcp-server.

### Not established by this review

 - The server was not installed and no Xero API call was executed.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/README.md)
 - The README gives no shell command. Its Claude Desktop block, shown as configExample, runs npx -y @xeroapi/xero-mcp-server@latest with the connection credentials in the environment.
- Create a Xero custom connection with the required scopes for its creation date, or use XERO_CLIENT_BEARER_TOKEN for multi-account use.
- Start against a demo company before connecting production accounting data.

### Before you start

 - Node.js 18 or higher.
- A Xero developer account with API credentials.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "xero": {
 "command": "npx",
 "args": [
 "-y",
 "@xeroapi/xero-mcp-server@latest"
 ],
 "env": {
 "XERO_CLIENT_ID": "your_client_id_here",
 "XERO_CLIENT_SECRET": "your_client_secret_here",
 "XERO_SCOPES": "accounting.invoices accounting.contacts accounting.settings"
 }
 }
 }
} Copy configuration ↗

### Compatibility

MCP clients supporting stdio with Node.js 18 or higher. · A Xero developer account with a custom connection or bearer token credentials.

### Implementation

TypeScript

### Transports

stdio

### Xero OAuth2 custom connection or bearer token

 - Custom connection: XERO_CLIENT_ID and XERO_CLIENT_SECRET for one organisation. Bearer token: XERO_CLIENT_BEARER_TOKEN, which takes precedence when set.
- Reads accounts, reports, payroll records and other organisation data; writes contacts, invoices, quotes, credit notes, payments, bank transactions, items, manual journals, tracking categories and payroll timesheets, all within the scopes granted.

### Cost model

Open source under MIT; a Xero subscription or demo company provides the data.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Xero MCP Server readme at pinned revision ↗](https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/README.md) Checked 2026-10-13 https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/README.md Supports: summary, upstreamDescription, install, configExample, access, transports, whySelected, bestFor, limitations
- [package.json manifest at pinned revision ↗](https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/package.json) Checked 2026-10-13 https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/package.json Supports: language, license, install
- [Repository licence at pinned revision ↗](https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/LICENSE) Checked 2026-10-13 https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/LICENSE Supports: license

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Xero Remote Accounting MCP ↗ Reads and changes accounting records in Xero organisations that have authorized the application and requested scopes.](/mcp-servers/xero-remote/)[### Brave Search MCP ↗ Provides web, news, image, video and place search using the Brave Search API.](/mcp-servers/brave/)[### Cloudflare API MCP ↗ Lets an assistant discover Cloudflare API endpoints and execute API calls through code, within the granted Cloudflare permissions.](/mcp-servers/cloudflare-code/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
