Skip to content
MCP server

Xero MCP

Xero Accounting reads plus a local SQLite ledger for aging and GL tie-out

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.1.14
Listing updated
2 days ago

About Xero MCP

Xero MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

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

{
  "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>"
      }
    }
  }
}

Configuration

  • XERO_ACCESS_TOKENSet the XERO_ACCESS_TOKEN credential for the Xero MCP server.Required
  • XERO_AUTHORIZATION_URLAuthorization endpoint the login flow opens. Change it only if Xero moves the endpoint.
  • XERO_BASE_URLBase URL for the Xero API. Leave the prefilled default unless your account uses a different regional or self-hosted host.
  • XERO_CLIENT_IDClient ID of your Xero app (developer.xero.com > My Apps). Set it with the client secret to run the OAuth2 flow; leave blank if you paste an access token instead.
  • XERO_CLIENT_SECRETClient secret paired with XERO_CLIENT_ID.
  • XERO_OAUTH2Optional. Sets XERO_OAUTH2 for the Xero MCP server.
  • XERO_TENANT_IDThe Xero organisation ('tenant') GUID sent as the Xero-Tenant-Id header. Every call requires it; `connections list` returns the tenants your token can reach.Required
  • XERO_TOKEN_URLToken endpoint the client-credentials exchange posts to. Leave the prefilled default unless your tenant uses a different token endpoint.
  • XERO_NO_CONFIG_WRITESet to 1 to keep credentials off disk. The token cache becomes a no-op, so the connector mints a fresh token each run instead of writing one to config.toml. Leave blank for the default cached behaviour.
  • PRINTING_PRESS_CLIENT_PROFILEOnly for tenant-gated multi-client deployments: binds the MCP server to an existing client profile. Leave blank for a single-tenant install.
  • XERO_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any state-changing execute call. Leave blank to keep every tool available (writes still need confirm).
  • XERO_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API and the response cache is off. Leave blank to keep the local data.
  • XERO_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http (a remote/hosted deployment). Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses.
  • XERO_USER_AGENTOverrides the User-Agent the CLI sends on Xero requests. Leave blank to use the CLI's own built-in User-Agent.
  • XERO_SCOPESComma or space separated OAuth scopes requested by auth login, replacing the default set. Leave blank for the default scopes.

What it does

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

Pricing

Open source

Xero MCP 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 to Xero MCP

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government