Skip to content
MCP server

Xero

Read-only Xero accounting data (invoices, contacts, P&L, chart of accounts) for AI clients

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Xero

Xero is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/xero/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xero": {
      "url": "https://gateway.pipeworx.io/xero/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous (50 calls/day) and free account (200 calls/day); paid tiers from $49/month or pay-as-you-go credits.

Prices change. Check pipeworx.io before you buy.

Xero 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.

How AIPoweredBot checks servers