Log inSubmit server
Xero MCP Server logo

Xero MCP Server

by XeroAPI

Connects MCP clients to Xero for accounting data access, reporting, payroll queries, and selected record management.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Xero MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "xeroapi-xero-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@xeroapi/xero-mcp-server@latest"
      ],
      "env": {
        "XERO_CLIENT_ID": "YOUR_VALUE_HERE",
        "XERO_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "XERO_SCOPES": "YOUR_VALUE_HERE",
        "XERO_CLIENT_BEARER_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @xeroapi/xero-mcp-server@latest

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 24d ago.

Overview

XeroAPI/xero-mcp-server MCP server connects MCP-compatible clients to Xero's accounting and business APIs. It supports OAuth2 custom connections and bearer-token authentication, with tools for querying and managing contacts, invoices, accounts, payments, reports, payroll data, and more. Reach for it when an agent needs structured access to Xero records through a standardized MCP interface.

Use cases

  • Query Xero accounts and financial reports
  • Create and update invoices and contacts
  • Review payments, bank transactions, and credit notes
  • Manage payroll timesheets and leave data
  • Inspect organisation and tracking information

Key features

  • OAuth2 custom-connection authentication
  • Bearer-token authentication
  • Accounting and financial report queries
  • Invoice, contact, payment, and transaction management
  • Payroll and timesheet operations
  • MCP-compliant tool interface

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @xeroapi/xero-mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars386Stargazers on the source repository.
npm downloads10kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Xero MCP Server works

What XeroAPI/xero-mcp-server MCP server does

XeroAPI/xero-mcp-server MCP server provides an MCP interface to Xero's accounting and business features. It lets an MCP client retrieve information from a connected Xero organisation and perform supported create, update, approval, revert, and delete operations.

The available operations cover contacts, accounts, invoices, credit notes, items, quotes, payments, bank transactions, manual journals, tax rates, tracking categories, and organisation details. Reporting tools include profit and loss, balance sheet, trial balance, aged receivables, and aged payables. Payroll-related tools cover employees, leave records and balances, leave types, leave periods, and timesheets.

How it works

The server translates MCP tool calls into requests to Xero's API. It supports two authentication approaches. Custom Connections use a client ID and client secret for a specific organisation and are presented in the documentation as the preferred option for testing, development, and third-party MCP clients such as Claude Desktop. Bearer-token mode is intended for scenarios involving multiple Xero accounts or an MCP client-managed authentication flow.

The bearer token takes precedence when it is configured alongside a client ID. Xero permissions must match the operations the client will perform. Custom Connections use the applicable bundled or granular scope set, while bearer-token setups require scopes for the accounting, reporting, contacts, settings, payroll, or other APIs being used.

Setup and configuration

Running XeroAPI/xero-mcp-server requires Node.js 18 or later, npm or pnpm, and a Xero developer account with API credentials. The repository can be installed with npm or pnpm and built with the corresponding build command. The README also provides an npx configuration for connecting the packaged server to Claude Desktop.

Custom Connection setups use XERO_CLIENT_ID and XERO_CLIENT_SECRET. XERO_SCOPES is optional and accepts a space-separated scope list; if omitted, the server uses its default scopes. Bearer-token setups use XERO_CLIENT_BEARER_TOKEN instead. A Xero account and organisation are required, and the documentation recommends starting with a Demo Company containing sample data. Payroll-specific queries require an organisation in the NZ or UK region.

Tools and capabilities

The command set includes:

  • Listing accounts, contacts, invoices, credit notes, items, quotes, payments, bank transactions, manual journals, tax rates, organisation details, and tracking data.
  • Reading financial reports, including profit and loss, balance sheet, trial balance, aged receivables, and aged payables.
  • Querying payroll employees, leave information, leave types, leave periods, and timesheets.
  • Creating contacts, invoices, credit notes, items, quotes, payments, bank transactions, manual journals, tracking categories, tracking options, and payroll timesheets.
  • Updating supported contacts, draft invoices, items, quotes, credit notes, bank transactions, manual journals, tracking categories, tracking options, and payroll timesheet lines.
  • Approving, reverting, adding lines to, retrieving, and deleting payroll timesheets.

Limitations and notes

Access depends on the Xero credentials, organisation, region, and OAuth scopes configured for the connection. Some Xero scopes are deprecated in favor of more granular scopes, so token configuration should follow Xero's current OAuth documentation. The listed invoice, quote, and credit-note update operations apply to draft records according to the tool descriptions. XeroAPI/xero-mcp-server belongs in the 💰 Finance & Fintech category and is intended for clients that can run MCP servers; the provided setup instructions specifically document Claude Desktop integration.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Xero MCP Server

XeroAPI/xero-mcp-server is an MCP server that connects AI clients to Xero's accounting API and exposes tools for contacts, accounts, invoices, reports, payments, transactions, payroll, quotes, items, and tracking data. It supports reading, creating, and updating selected Xero records through MCP, subject to configured authentication and scopes.

Install it with npm or pnpm, then build it with the repository's build command. For Claude Desktop, the documented packaged setup runs `npx -y @xeroapi/xero-mcp-server@latest` and supplies the required Xero credentials through environment variables.

Use either a Xero Custom Connection with `XERO_CLIENT_ID` and `XERO_CLIENT_SECRET`, or provide `XERO_CLIENT_BEARER_TOKEN` for bearer-token authentication. `XERO_SCOPES` can override the default custom-connection scopes, and the bearer token takes precedence when both authentication configurations are present.

Yes, Claude Desktop is explicitly supported in the setup instructions. Add the server to `claude_desktop_config.json`, run it with `npx` or a local Node.js path, and provide the relevant Xero authentication environment variables.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewXero MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/xeroapi-xero-mcp-server?style=directory)](https://allmcps.com/mcp/xeroapi-xero-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/xeroapi-xero-mcp-server"><img src="https://allmcps.com/api/badge/xeroapi-xero-mcp-server?style=directory" alt="Xero MCP Server on AllMCPs" /></a>