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.
“It provides a bridge between the MCP protocol and Xero's API, allowing for standardized access to Xero's accounting and business features.”
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.
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.
- 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"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/README.md
Supports: summary, upstreamDescription, install, configExample, access, transports, whySelected, bestFor, limitations
https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/package.json
Supports: language, license, install
https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/LICENSE
Supports: license