xero-mcp-server

This repository provides a Model Context Protocol (MCP) server for Xero, bridging the gap between the MCP protocol and Xero's API for standardized access to accounting and business features.

96
1

Xero MCP Server

This is a Model Context Protocol (MCP) server implementation for Xero, acting as a bridge between the MCP protocol and Xero's API. It enables standardized access to Xero's accounting and business functionalities.

Features

  • Xero OAuth2 authentication with custom connections.
  • Management of contacts and chart of accounts.
  • Creation and management of invoices.
  • MCP protocol compliance.

Prerequisites

  • Node.js (v18 or higher) and npm or pnpm.
  • A Xero developer account with API credentials, configured with a Custom Connection and the scopes accounting.transactions accounting.contacts accounting.settings.read.

Integrating the MCP server with Claude Desktop

To integrate, add the provided JSON configuration to Claude Desktop's claude_desktop_config.json file, ensuring to replace placeholders with your Xero Client ID and Secret.

Available MCP Commands

The server supports commands like list-contacts, list-invoices, list-accounts, list-tax-rates, list-quotes, list-credit-notes, create-contact, create-invoice, create-quote, create-credit-note, update-contact, and update-invoice. Refer to the MCP Protocol Specification for detailed API documentation.

For Developers

Installation

Use npm install or pnpm install to install dependencies.

Run a build

Use npm run build or pnpm build to build the project.

Integrating with Claude Desktop

To integrate, add the provided JSON configuration to Claude Desktop's claude_desktop_config.json file, ensuring to replace placeholders with your Xero Client ID, Secret and the correct file path.

License

MIT

Security

Avoid committing sensitive credentials to version control.

Repository

XE
XeroAPI

XeroAPI/xero-mcp-server

Created

March 17, 2025

Updated

March 28, 2025

Language

TypeScript

Category

Developer Tools