← Explore all 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.

“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.

Upstream setup instructions ↗
  1. 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.
  2. Create a Xero custom connection with the required scopes for its creation date, or use XERO_CLIENT_BEARER_TOKEN for multi-account use.
  3. 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.

  1. https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/README.md

    Supports: summary, upstreamDescription, install, configExample, access, transports, whySelected, bestFor, limitations

  2. https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/package.json

    Supports: language, license, install

  3. https://github.com/XeroAPI/xero-mcp-server/blob/f24583c867df7c1f4806f7532eb0691e85892865/LICENSE

    Supports: license

Evidence & Ask