Skip to content
Xero MCP Server

Xero MCP Server

by Xero
Released
11 views
v0.0.17
MIT
Repository Docs npm
Featured Payments & Commerce

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: Aave MCP

by Aave

Featured

Aave's official MCP server: live V3 and V4 markets, wallet positions and health factor, DAO governance, and unsigned transactions your own wallet signs.

Payments & Commerce
8 views

MCP: Shippo

by Shippo

New

Shippo's official MCP server for multi-carrier shipping — compare rates, buy labels, track parcels and validate addresses, with reads free and purchases gated.

Payments & Commerce
2 views

MCP: Meta Ads MCP

by Meta

Meta's hosted MCP server for Facebook and Instagram advertising: reporting, campaign and creative writes, catalogues, signal health and lift studies.

Payments & Commerce
5 views
Browse all MCP servers →