Skip to content
Xero MCP Server

Xero MCP Server

by Xero
v0.0.17
MIT
Repository Docs npm
Featured Payments & Commerce
xeroaccountinginvoicingpayrollfinancebookkeeping

Summary

Official Xero MCP server that lets an agent read and write a real accounting ledger — invoices, contacts, payments, payroll timesheets and financial reports — over the Xero API.

Features

  • About 50 tools spanning the Xero Accounting and Payroll APIs
  • Read invoices, contacts, credit notes, quotes, items, payments and bank transactions
  • Financial reports: profit and loss, balance sheet, trial balance, aged receivables and payables
  • Create and update invoices, contacts, quotes, credit notes, manual journals and payments
  • Full payroll timesheet workflow — create, add lines, update, approve or revert
  • OAuth 2.0 custom connections or a pre-minted bearer token, with configurable scopes

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "Xero MCP Server" tools will be available.
{
  "mcpServers": {
    "xero-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@xeroapi/xero-mcp-server@latest"
      ],
      "env": {
        "XERO_CLIENT_ID": "your_client_id",
        "XERO_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Description

The Xero MCP Server is Xero's own Model Context Protocol bridge to its cloud accounting platform. It turns the Xero Accounting and Payroll APIs into roughly fifty MCP tools, so an assistant can answer "what is still unpaid from last quarter?" or draft an invoice without anyone opening the Xero web app.

What it can reach

The tool surface splits cleanly into reads and writes.

Reads cover the chart of accounts, contacts and contact groups, invoices, quotes, credit notes, items, manual journals, payments, bank transactions, tax rates and tracking categories. On the reporting side it exposes profit and loss, balance sheet, trial balance, and aged receivables/payables broken down by contact. Payroll reads include employees, leave, leave balances, leave types, leave periods and timesheets.

Writes cover creating and updating contacts, invoices, quotes, credit notes, items, manual journals, payments, bank transactions and tracking categories, plus a full payroll timesheet workflow — create a timesheet, add lines, update a line, then approve or revert it.

Authentication

Two paths, both OAuth 2.0. A custom connection uses XERO_CLIENT_ID and XERO_CLIENT_SECRET for machine-to-machine access to a single organisation, which is the usual choice for an agent running unattended. Alternatively, pass an already-minted XERO_CLIENT_BEARER_TOKEN, which takes precedence over the client credentials. XERO_SCOPES narrows what the connection is allowed to touch — worth setting, because the default grant is broad and this server can move real money records.

Practical notes

It ships as an npm package and runs under npx, so there is nothing to build. It is MIT licensed and maintained in the XeroAPI GitHub organisation alongside the Xero Agent Toolkit, a companion set of examples showing the same tools driven from Python agent frameworks.

Treat the write tools with the caution you would give any bookkeeping automation: they post to a live ledger, and Xero's own guidance is to point an agent at a demo organisation first.

Related MCP Servers

MCP: Plaid Sandbox MCP Server

by Plaid

New

Plaid's official sandbox MCP server: search Plaid docs, mint sandbox access tokens, generate mock financial data and fire test webhooks while building an integration.

Developer ToolsPayments & Commerce

MCP: Adyen MCP Server

by Adyen

New

Adyen's official MCP server (alpha) — create checkout sessions and payment links, refund or cancel payments, and manage merchant accounts and terminals.

Payments & Commerce
1 views

MCP: commercetools Commerce MCP

by commercetools

Official commercetools MCP server exposing products, carts, orders, customers and the rest of the Composable Commerce API as scoped, selectable agent tools.

Payments & Commerce
1 views

MCP: Shopify Dev

by Shopify

Shopify's official developer MCP server — accurate API docs and schema introspection for building Shopify apps.

Payments & Commerce
Browse all MCP servers →