Overview
Xero MCP Server implements a Model Context Protocol bridge for Xero, exposing Xero's accounting features through the MCP interface. It authenticates to Xero via OAuth2, offering two modes: Custom Connections (per-organisation client IDs and secrets) and Bearer Token (runtime multi-account access). Custom Connections are recommended for testing and for integrating with third-party MCP clients such as Claude Desktop; you configure required scopes to access Xero data. The server supports a broad set of MCP commands to list and manage core resources (accounts, contacts, invoices, items) as well as payroll data, bank transactions, quotes, and financial reports (profit and loss, balance sheet, trial balance). It is designed to be MCP protocol compliant and includes integration guidance for Claude Desktop with example configurations. Prerequisites include Node.js v18+, npm or pnpm, and a Xero developer account with API credentials. The project is MIT licensed and emphasizes secure handling of credentials via environment variables rather than committing secrets.
Features
Xero OAuth2 authentication with custom connections
Supports OAuth2 authentication with per-organisation client IDs and secrets via Custom Connections for testing and third-party MCP client integration (e.g., Claude Desktop).
Contact management
Expose MCP access to Xero contacts for listing, creating, and updating contacts.
Chart of Accounts management
Access and manage the Xero Chart of Accounts through MCP commands.
Invoice creation and management
Create and manage invoices via MCP, aligning with Xero's accounting data.
MCP protocol compliance
Ensure MCP protocol compatibility and provide guidance per the MCP Specification.
Who Is This For?
- Developers:Developers building MCP clients or integrating Claude Desktop with Xero accounting data.
- Systems integrators:Enable multi-account access by routing MCP queries through OAuth2 or token-based flows.
