MCP Server 🐳 Docker

Xero MCP

MCP server for Xero accounting. Manage contacts, invoices, payments, chart of accounts, and run financial reports.

Installation

Run the MCP server with npx:

npx @wyre-technology/xero-mcp

Or install the package:

npm install @wyre-technology/xero-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": [
        "@wyre-technology/xero-mcp"
      ],
      "env": {
        "XERO_ACCESS_TOKEN": "your-xero-access-token",
        "XERO_TENANT_ID": "your-xero-tenant-id"
      }
    }
  }
}

Authentication

Variable	Required	Description
`XERO_ACCESS_TOKEN`	Yes	OAuth 2.0 access token for Xero
`XERO_TENANT_ID`	Yes	Your Xero organisation/tenant ID

Architecture

Single TypeScript MCP server supporting both stdio and Streamable HTTP transports.

Available Tools (17)

Tools are organized into 5 domains:

Contacts

Manage customers and suppliers.

Tool	Description
`List contacts`	List contacts with filtering
`Get contact`	Get contact details
`Create contact`	Create a new contact
`Search contacts`	Search contacts by name or email

Invoices

Create and manage sales invoices.

Tool	Description
`List invoices`	List invoices with filtering
`Get invoice`	Get invoice details
`Create invoice`	Create a new invoice
`Update invoice status`	Approve, void, or submit an invoice

Payments

Record and view payments.

Tool	Description
`List payments`	List payments with filtering
`Get payment`	Get payment details
`Create payment`	Record a payment against an invoice

Accounts

Browse the chart of accounts.

Tool	Description
`List accounts`	List chart of accounts
`Get account`	Get account details

Reports

Generate financial reports.

Tool	Description
`Profit & Loss`	Generate a P&L report
`Balance Sheet`	Generate a balance sheet report
`Aged Receivables`	Generate aged receivables report
`Aged Payables`	Generate aged payables report