How do I install Xero?

Xero is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Xero need?

Xero requires the following credentials or environment variables: XERO_TENANT_ID, XERO_ACCESS_TOKEN, MCP_TRANSPORT, AUTH_MODE, LOG_LEVEL. You can find setup instructions on the server detail page.

What AI apps work with Xero?

Xero uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Xero MCP Server

by Wyre Technology

Business ToolsUse Caution4.7MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP server for Xero accounting — contacts, invoices, payments, accounts, and financial reports.

About

MCP server for Xero accounting — contacts, invoices, payments, accounts, and financial reports.

Security Report

4.7

Use Caution4.7High Risk

The Xero MCP server is well-structured with proper authentication mechanisms and reasonable permission scoping for its financial accounting purpose. However, there are notable concerns with input validation and error handling that could expose sensitive information or enable API abuse. The gateway authentication mode is a significant security strength, but credential handling in stdio mode lacks validation. Code quality issues around input sanitization and error messages should be addressed before production use. Supply chain analysis found 2 known vulnerabilities in dependencies (1 critical, 0 high severity).

7 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Xero tenant ID (organisation). Required when AUTH_MODE is 'env'.Optional

Environment variable: XERO_TENANT_ID

Xero OAuth2 access token. Required when AUTH_MODE is 'env'.Required

Environment variable: XERO_ACCESS_TOKEN

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.Optional

Environment variable: MCP_TRANSPORT

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.Optional

Environment variable: AUTH_MODE

Log verbosity: debug, info, warn, errorOptional

Environment variable: LOG_LEVEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-wyre-technology-xero-mcp": {
      "env": {
        "AUTH_MODE": "your-auth-mode-here",
        "LOG_LEVEL": "your-log-level-here",
        "MCP_TRANSPORT": "your-mcp-transport-here",
        "XERO_TENANT_ID": "your-xero-tenant-id-here",
        "XERO_ACCESS_TOKEN": "your-xero-access-token-here"
      },
      "args": [
        "-y",
        "@wyre-technology/xero-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Xero MCP Server

Model Context Protocol (MCP) server for the Xero Accounting API. Enables Claude and other MCP-compatible clients to manage Xero contacts, invoices, payments, accounts, and reports.

One-Click Deployment

Quick Start

Prerequisites

Node.js >= 20
Xero OAuth2 app credentials (requires a Xero developer account)

Install and Build

npm install
npm run build

Run (stdio mode)

XERO_ACCESS_TOKEN=your-access-token XERO_TENANT_ID=your-tenant-id npm start

Run (HTTP mode)

MCP_TRANSPORT=http XERO_ACCESS_TOKEN=your-access-token XERO_TENANT_ID=your-tenant-id npm start

The server listens on http://0.0.0.0:8080/mcp by default.

Docker

docker build -t xero-mcp .
docker run -p 8080:8080 \
  -e MCP_TRANSPORT=http \
  -e XERO_ACCESS_TOKEN=your-access-token \
  -e XERO_TENANT_ID=your-tenant-id \
  xero-mcp

Environment Variables

Variable	Required	Default	Description
`XERO_ACCESS_TOKEN`	Yes (env mode)	—	Xero OAuth2 access token
`XERO_TENANT_ID`	Yes (env mode)	—	Xero tenant ID (organisation)
`MCP_TRANSPORT`	No	`stdio`	Transport type: `stdio` or `http`
`MCP_HTTP_PORT`	No	`8080`	HTTP server port
`MCP_HTTP_HOST`	No	`0.0.0.0`	HTTP server bind address
`AUTH_MODE`	No	`env`	Auth mode: `env` or `gateway`

Gateway Mode

When AUTH_MODE=gateway, credentials are passed per-request via HTTP headers instead of environment variables:

X-Xero-Access-Token — OAuth2 access token
X-Xero-Tenant-Id — Xero tenant ID

This allows a gateway/proxy to manage multi-tenant credentials.

Available Tools

Tools are organized into domains. Use xero_navigate to select a domain, then use the domain-specific tools.

Navigation

xero_navigate — Select a domain (contacts, invoices, payments, accounts, reports)
xero_back — Return to domain selection

Contacts

xero_contacts_list — List contacts with pagination and optional filtering
xero_contacts_get — Get detailed contact information by ID
xero_contacts_create — Create a new contact (customer or supplier)
xero_contacts_search — Search contacts by name

Invoices

xero_invoices_list — List invoices with optional status and type filters
xero_invoices_get — Get detailed invoice information by ID
xero_invoices_create — Create a new invoice (sales or bill)
xero_invoices_update_status — Update invoice status (submit, authorise, void)

Payments

xero_payments_list — List payments with optional status filter
xero_payments_get — Get detailed payment information by ID
xero_payments_create — Record a payment against an invoice

Accounts

xero_accounts_list — List chart of accounts with optional type/class filter
xero_accounts_get — Get detailed account information by ID

Reports

xero_reports_profit_and_loss — Profit and Loss (income statement) for a date range
xero_reports_balance_sheet — Balance Sheet as of a specific date
xero_reports_aged_receivables — Aged Receivables by contact
xero_reports_aged_payables — Aged Payables by contact

License

Apache-2.0

Reviews

No reviews yet

Be the first to review this server!

More Business Tools MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Xero MCP Server

About

Security Report

Findings (12)Action required

Permissions Required

What You'll Need

How to Install

Documentation

Xero MCP Server

One-Click Deployment

Quick Start

Prerequisites

Install and Build

Run (stdio mode)

Run (HTTP mode)

Docker

Environment Variables

Gateway Mode

Available Tools

Navigation

Contacts

Invoices

Payments

Accounts

Reports

License

Reviews

No reviews yet

More Business Tools MCP Servers

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent

Google Workspace MCP