# Xero

> Xero is a freemium MCP server for finance and payments. Read-only Xero accounting data (invoices, contacts, P&L, chart of accounts) for AI clients. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web
- **Website:** https://pipeworx.io/packs/xero
- **Repository:** https://github.com/pipeworx-io/mcp-xero
- **MCP Registry name:** io.github.pipeworx-io/xero
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The Xero MCP pack connects an AI client to Xero accounting organisations through OAuth and the Pipeworx gateway. The README says it is an independent, unofficial integration rather than one published by Xero. Because Xero accounts can hold several organisations, the first step is usually listing the tenants the connected account can reach, then passing the chosen tenant id to the other tools.

The pack exposes five tools: organisation listing, invoice and bill summaries with filter and pagination support, contact lists covering customers and suppliers, the Profit and Loss report for an optional date range, and the chart of accounts. Each returns structured fields such as totals, amounts due, statuses and account codes.

It suits bookkeepers, finance staff and developers building assistants that review receivables, payables or period results. The README notes that connections also list shared gateway meta-tools, and that a Pipeworx key is needed for a connected Xero account.

## Features

- **Multi-organisation discovery:** Lists the Xero tenants the connected account can access, with tenant id, name and type.
- **Invoice and bill summaries:** Returns compact invoice records with status, contact, dates, totals and amount due, with filter and pagination support.
- **Contact listing:** Returns customers and suppliers with email, status and customer or supplier flags.
- **Profit and Loss report:** Pulls the structured income statement for an optional date range.
- **Chart of accounts:** Lists account codes, names, types, classes and statuses.

## Good for

- Reviewing overdue receivables and open payables in an assistant
- Pulling a Profit and Loss summary for a chosen period
- Checking the chart of accounts before categorising transactions
- Finding customer or supplier records across a Xero organisation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http xero https://gateway.pipeworx.io/xero/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/xero/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "xero": {
      "url": "https://gateway.pipeworx.io/xero/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "xero": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/xero/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "xero": {
      "serverUrl": "https://gateway.pipeworx.io/xero/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "xero": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/xero/mcp"
    }
  }
}
```

## Tools

- `list_organisations`: List the Xero organisations (tenants) the connected account can access, with tenant id, name, and type.
- `list_invoices`: List invoices and bills from a Xero accounting organisation with summaries, filters and pagination.
- `list_contacts`: List contacts (customers and suppliers) from a Xero accounting organisation.
- `get_profit_and_loss`: Get the Profit and Loss report from a Xero accounting organisation for an optional date range.
- `list_accounts`: List the chart of accounts from a Xero accounting organisation.

## FAQ

### Does the pack need a Pipeworx key?

The README says calls without a key are anonymous and capped daily, and that connecting a Xero account requires a Pipeworx key for the hosted endpoint. A free account raises the daily cap.

### How do I target a specific Xero organisation?

Call list_organisations first to get the tenant id, then pass that id to the other accounting tools.

### Is this an official Xero integration?

No. The README describes it as an independent, unofficial integration not affiliated with or endorsed by Xero.

### Which packages are available?

The registry lists an npm package, @pipeworx/mcp-xero, that runs as a local stdio bridge, plus a streamable-http remote endpoint.

### Is Xero free?

Xero has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Xero to Claude Code?

Run this command in your terminal: claude mcp add --transport http xero https://gateway.pipeworx.io/xero/mcp

### What are the best alternatives to Xero?

The closest alternatives to Xero are Xero, Zero Plus One MCP by usefulapi, xpnAI, Xero MCP and Quipu MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Xero](https://ai-powered.com/mcp/xero-5): Xero is an open-source MCP server for finance and payments.
- [Zero Plus One MCP by usefulapi](https://ai-powered.com/mcp/zero-plus-one-mcp-by-usefulapi): Zero Plus One MCP by usefulapi is a freemium MCP server for finance and payments.
- [xpnAI](https://ai-powered.com/mcp/xpnai): xpnAI is an MCP server for finance and payments.
- [Xero MCP](https://ai-powered.com/mcp/xero-mcp): Xero MCP is an open-source MCP server for finance and payments.
- [Quipu MCP by usefulapi](https://ai-powered.com/mcp/quipu-mcp-by-usefulapi): Quipu MCP by usefulapi is a freemium MCP server for finance and payments.
- [Invoiced MCP by usefulapi](https://ai-powered.com/mcp/invoiced-mcp-by-usefulapi): Invoiced MCP by usefulapi is a freemium MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.
- [SmartAccounts MCP by usefulapi](https://ai-powered.com/mcp/smartaccounts-mcp-by-usefulapi): SmartAccounts MCP by usefulapi is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/xero-2
