This project provides a Model Context Protocol (MCP) server implementation for Xero, acting as a bridge between the MCP protocol and Xero's comprehensive accounting and business APIs. It enables developers to integrate Xero's financial data and functionalities into MCP-compliant applications, offering standardized access and simplifying data exchange for users and third-party clients like Claude Desktop.

How It Works

The server is built using Node.js, leveraging npm or pnpm for package management. It implements the MCP protocol to translate standardized requests into Xero API calls. Authentication is handled via Xero's OAuth2, supporting either Custom Connections for development and specific organization integrations or a Bearer Token approach for broader, client-driven authentication flows. The architecture exposes a rich set of MCP commands for retrieving and manipulating Xero data, including contacts, invoices, bank transactions, and payroll information.

Quick Start & Requirements

• Primary Install/Run: npm install or pnpm install followed by npm run build or pnpm build. Integration typically involves configuring the server via npx within an MCP client's settings.
• Prerequisites: Node.js (v18 or higher), npm or pnpm, and a Xero developer account with API credentials. A Xero Demo Company is recommended for initial setup.
• Links:
  • MCP Introduction: https://modelcontextprotocol.io/introduction
  • Xero Developer Documentation: https://developer.xero.com/documentation/
  • Custom Connections Guide: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

Highlighted Details

• Authentication: Supports Xero OAuth2 via Custom Connections (client ID/secret) or Bearer Token, with precedence given to the latter.
• Functionality: Manages contacts, chart of accounts, invoices, credit notes, payments, bank transactions, manual journals, items, quotes, tracking categories, and payroll data.
• MCP Commands: Offers extensive CRUD operations and data retrieval commands for various Xero modules, including detailed payroll functions.
• Integration: Includes specific configuration examples for integrating with Claude Desktop.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels (e.g., Discord, Slack). It primarily links to official Xero developer resources.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license permits commercial use and integration with closed-source applications without significant restrictions.

Limitations & Caveats

The project requires Node.js v18 or higher. Payroll-specific queries are recommended for NZ or UK regions. Users employing Node Version Manager (NVM) must configure the command path explicitly. Some scopes used for Bearer Token authentication are noted as deprecated, necessitating reference to Xero's latest OAuth 2.0 Scopes documentation.