Skip to main content
Glama
Xero Expenses MCP

Xero Expenses MCP

by muness

xero-expenses-mcp

MCP (Model Context Protocol) server for Xero accounting. Supports Invoices, Bills, Expenses (Bank Transactions), and Expense Claims with PKCE authentication.

Features

  • Invoices (ACCREC) - Create sales invoices to send to customers

  • Bills (ACCPAY) - Create bills you'll pay later

  • Expenses - Create "Spend Money" bank transactions for already-paid expenses

  • Expense Claims - Create receipts and submit expense claims for reimbursement

  • Attachments - Attach PDFs and images to invoices, bills, expenses, and receipts

  • PKCE Auth - Desktop app OAuth flow (no client secret required)

Related MCP server: xero-oauth-mcp-server

Installation

npx xero-expenses-mcp

Or install globally:

npm install -g xero-expenses-mcp

Xero App Setup

  1. Go to Xero Developer Portal

  2. Create a new app:

    • App name: Your choice (e.g., "Expense Manager")

    • Integration type: "Mobile or desktop app" (uses PKCE, no secret needed)

    • Redirect URI: http://localhost:3000/callback

  3. Note your Client ID

Claude Code Configuration

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "xero-expenses": {
      "command": "npx",
      "args": ["xero-expenses-mcp"],
      "env": {
        "XERO_CLIENT_ID": "YOUR_CLIENT_ID"
      }
    }
  }
}

Or use the CLI:

claude mcp add xero-expenses -- npx xero-expenses-mcp

Then set environment variables in your shell or .env file.

Environment Variables

Variable

Required

Description

XERO_CLIENT_ID

Yes

Your Xero app's client ID

XERO_CLIENT_SECRET

No

Only for Web apps (not PKCE)

XERO_REDIRECT_URI

No

Default: http://localhost:3000/callback

Authentication

On first use, the server will open a browser for Xero OAuth. After authenticating, tokens are stored in ~/.xero-mcp/token.json.

Available Tools

Accounts & Contacts

  • xero_list_accounts - List expense accounts/categories

  • xero_list_bank_accounts - List bank accounts

  • xero_list_contacts - Search vendors/contacts

  • xero_list_users - List organization users (for expense claims)

Invoices (Accounts Receivable)

  • xero_create_invoice - Create a sales invoice to send to customers

  • xero_attach_file_to_invoice - Attach file to an invoice

Bills (Accounts Payable)

  • xero_create_bill - Create a bill for future payment

  • xero_attach_file - Attach file to a bill

Expenses (Bank Transactions)

  • xero_create_expense - Create a "Spend Money" transaction

  • xero_attach_file_to_expense - Attach file to an expense

Expense Claims (deprecated Feb 2026)

  • xero_create_expense_claim - Create receipt + expense claim

  • xero_attach_file_to_receipt - Attach file to a receipt

Example Usage

In Claude Code:

"Create an expense for $45.50 lunch at Cafe Example on 2024-01-15, categorize as Business Meals (account 620)"

Claude will use the xero_create_expense_claim tool with:

{
  "vendorName": "Cafe Example",
  "amount": 45.50,
  "description": "Lunch",
  "accountCode": "620",
  "date": "2024-01-15"
}

Token Storage

Tokens are stored in ~/.xero-mcp/token.json. To re-authenticate, delete this file.

License

MIT

Available Tools

21 tools
xero_add_line_item_to_billA

Add a line item (expense) to an existing DRAFT bill

Inputs: invoiceId (required), description (required), amount (required), accountCode (required), +1 more.

xero_attach_fileC

Attach a file (PDF, image) to an existing Xero bill

Inputs: invoiceId (required), filePath (required).

xero_attach_file_to_expenseC

Attach a file (PDF, image) to an existing Xero expense (bank transaction)

Inputs: bankTransactionId (required), filePath (required).

xero_attach_file_to_invoiceC

Attach a file (PDF, image) to an existing Xero invoice

Inputs: invoiceId (required), filePath (required).

xero_attach_file_to_receiptC

Attach a file (PDF, image) to an existing Xero receipt

Inputs: receiptId (required), filePath (required).

xero_create_billB

Create a bill (accounts payable) in Xero - use for invoices you'll pay later

Inputs: vendorName (required), amount (required), description (required), vendorEmail, +4 more.

xero_create_expenseA

Create a spend money transaction (direct expense) in Xero - use for already-paid expenses like receipts

Inputs: vendorName (required), amount (required), description (required), vendorEmail, +4 more.

xero_create_expense_claimB

Create an expense claim for reimbursement - creates a receipt and submits it as an expense claim (deprecated Feb 2026)

Inputs: vendorName (required), amount (required), description (required), vendorEmail, +4 more.

xero_create_invoiceA

Create a sales invoice (accounts receivable) in Xero - use for invoices you send to customers

Inputs: customerName (required), amount (required), description (required), customerEmail, +4 more.

xero_create_receiptA

Create a receipt WITHOUT submitting as expense claim - use this to batch multiple receipts into one claim later

Inputs: vendorName (required), amount (required), description (required), vendorEmail, +4 more.

xero_get_billB

Get details of a specific bill including all line items

Inputs: invoiceId (required).

xero_get_expense_claimC

Get details of a specific expense claim including all receipts

Inputs: expenseClaimId (required).

xero_list_accountsB

List available Xero accounts/categories for expenses

Inputs: no named parameters.

xero_list_bank_accountsB

List available Xero bank accounts for expenses

Inputs: no named parameters.

xero_list_contactsC

Search for vendors/contacts in Xero

Inputs: search.

xero_list_draft_billsB

List draft bills (ACCPAY invoices) - use to find existing draft to add expenses to

Inputs: reference.

xero_list_expense_claimsB

List expense claims - optionally filter by status (SUBMITTED, AUTHORISED, PAID)

Inputs: status.

xero_list_receiptsC

List all receipts - optionally filter by user ID

Inputs: userId.

xero_list_usersB

List users in the Xero organization (for expense claims)

Inputs: no named parameters.

xero_submit_billB

Change a DRAFT bill to SUBMITTED status for approval

Inputs: invoiceId (required).

xero_submit_expense_claimA

Submit multiple receipts as a single expense claim - use after creating receipts with xero_create_receipt

Inputs: receiptIds (required), userId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific Xero entities (bills, expenses, invoices, receipts) with clear action verbs, but there is some potential confusion between xero_create_expense and xero_create_receipt as both handle expense-related creation. The descriptions help clarify, but the overlap in domain could cause misselection without careful reading.

    Naming Consistency5/5

    All tool names follow a consistent xero_verb_noun pattern with snake_case throughout, such as xero_create_bill, xero_list_expense_claims, and xero_attach_file_to_invoice. This predictability makes it easy for agents to understand and navigate the toolset without confusion from mixed conventions.

    Tool Count4/5

    With 21 tools, the count is on the higher side but reasonable for the comprehensive expense management domain, covering CRUD operations, file attachments, and listing across multiple entities. It might feel slightly heavy, but each tool appears to serve a specific function without obvious redundancy.

    Completeness5/5

    The toolset provides complete coverage for Xero expense management, including creation, retrieval, listing, and submission for bills, expenses, invoices, receipts, and claims, along with supporting operations like file attachments and listing accounts/contacts. There are no apparent gaps that would hinder agent workflows in this domain.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables interaction with the Xero Accounting API to manage contacts, invoices, payments, accounts, and financial reports. It provides a suite of tools for natural language access to accounting records and business performance data.
      20
      1
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables natural language interaction with Xero accounting data, managing contacts, invoices, and accounts across multiple organisations via OAuth2.
      12
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables accountants to connect Xero, read accounting data, analyze, and execute controlled draft operations after explicit confirmation, with Xero as the source of truth.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables free Xero accounting access through MCP clients by handling one-time PKCE sign-in and refresh-token persistence, letting users run the official Xero MCP server without a paid Custom Connection.
      7 npm
      MIT