# Xero MCP

> Xero MCP is an open-source MCP server for finance and payments. Xero Accounting reads plus a local SQLite ledger for aging and GL tie-out. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/servosity/msp-skills/tree/HEAD/skills/xero
- **MCP Registry name:** io.github.Servosity/xero-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

This server pairs read access to the Xero Accounting API with a local SQLite copy of the ledger, so reconciliation, aging and general-ledger tie-out run on the laptop rather than in Xero. The registry entry says it covers every Xero Accounting read and that these offline computations are not offered by other Xero tools.

It is a community project aimed at MSP owners and labelled unofficial, with no affiliation to Xero Limited. Every tool shells out to a companion xero-cli, which bundles with the .mcpb release from 18 September 2026 on. Authentication takes a Xero access token, with the authorization URL configurable.

The README carries a security warning: do not run HTTP mode, not even on localhost, because that build has no password, listens on every interface and predates the browser-rebinding guard; use the default stdio transport. The tools can also make changes with your credentials.

## Features

- **Full accounting reads:** Reads across the Xero Accounting API.
- **Local SQLite ledger:** Keeps a copy on disk for offline queries.
- **Aging reports:** Computes receivable and payable aging from the local ledger.
- **Reconciliation:** Compares bank and ledger data locally.
- **GL tie-out:** Checks the general ledger against supporting data.
- **Stdio by default:** The README tells users to avoid HTTP mode for now.

## Good for

- Produce an aging report for a client's receivables
- Tie out the general ledger without hitting the API repeatedly
- Reconcile accounts offline for an MSP's clients
- Ask an assistant for unpaid invoices over 60 days

## Install

### Claude Code (Terminal)

```sh
claude mcp add xero-mcp --env XERO_ACCESS_TOKEN='<XERO_ACCESS_TOKEN>' --env XERO_CLIENT_ID='<XERO_CLIENT_ID>' --env XERO_CLIENT_SECRET='<XERO_CLIENT_SECRET>' --env XERO_OAUTH2='<XERO_OAUTH2>' --env XERO_TENANT_ID='<XERO_TENANT_ID>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env XERO_MCP_HTTP_TOKEN='<XERO_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "xero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb"
      ],
      "env": {
        "XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_OAUTH2": "<XERO_OAUTH2>",
        "XERO_TENANT_ID": "<XERO_TENANT_ID>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "XERO_MCP_HTTP_TOKEN": "<XERO_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb"
      ],
      "env": {
        "XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_OAUTH2": "<XERO_OAUTH2>",
        "XERO_TENANT_ID": "<XERO_TENANT_ID>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "XERO_MCP_HTTP_TOKEN": "<XERO_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "xero-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb"
      ],
      "env": {
        "XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_OAUTH2": "<XERO_OAUTH2>",
        "XERO_TENANT_ID": "<XERO_TENANT_ID>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "XERO_MCP_HTTP_TOKEN": "<XERO_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb"
      ],
      "env": {
        "XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_OAUTH2": "<XERO_OAUTH2>",
        "XERO_TENANT_ID": "<XERO_TENANT_ID>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "XERO_MCP_HTTP_TOKEN": "<XERO_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb"
      ],
      "env": {
        "XERO_ACCESS_TOKEN": "<XERO_ACCESS_TOKEN>",
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_OAUTH2": "<XERO_OAUTH2>",
        "XERO_TENANT_ID": "<XERO_TENANT_ID>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "XERO_MCP_HTTP_TOKEN": "<XERO_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is it official?

No. It is described as unofficial and not affiliated with Xero Limited.

### Is HTTP mode safe?

The README says not to use it, even on localhost, until the connector is reprinted.

### What credential does it need?

A XERO_ACCESS_TOKEN.

### Does it need a separate CLI?

Tools call xero-cli; bundles from 2026-09-18 include it.

### Which AI apps work?

Claude Desktop, Claude Code, Codex, GitHub Copilot, Gemini CLI and the ChatGPT desktop app.

### Is Xero MCP free?

Yes. Xero MCP is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add xero-mcp --env XERO_ACCESS_TOKEN='<XERO_ACCESS_TOKEN>' --env XERO_CLIENT_ID='<XERO_CLIENT_ID>' --env XERO_CLIENT_SECRET='<XERO_CLIENT_SECRET>' --env XERO_OAUTH2='<XERO_OAUTH2>' --env XERO_TENANT_ID='<XERO_TENANT_ID>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env XERO_MCP_HTTP_TOKEN='<XERO_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/xero-v0.1.14/xero-mcp.mcpb

### What are the best alternatives to Xero MCP?

The closest alternatives to Xero MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

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