Xero Expenses MCP
Provides tools for managing Xero accounting operations including creating invoices, bills, bank transactions (expenses), and expense claims, with support for attachments and PKCE authentication.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Xero Expenses MCP Create an expense for $29.99 office supplies from Staples today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpOr install globally:
npm install -g xero-expenses-mcpXero App Setup
Go to Xero Developer Portal
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
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-mcpThen set environment variables in your shell or .env file.
Environment Variables
Variable | Required | Description |
| Yes | Your Xero app's client ID |
| No | Only for Web apps (not PKCE) |
| No | Default: |
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/categoriesxero_list_bank_accounts- List bank accountsxero_list_contacts- Search vendors/contactsxero_list_users- List organization users (for expense claims)
Invoices (Accounts Receivable)
xero_create_invoice- Create a sales invoice to send to customersxero_attach_file_to_invoice- Attach file to an invoice
Bills (Accounts Payable)
xero_create_bill- Create a bill for future paymentxero_attach_file- Attach file to a bill
Expenses (Bank Transactions)
xero_create_expense- Create a "Spend Money" transactionxero_attach_file_to_expense- Attach file to an expense
Expense Claims (deprecated Feb 2026)
xero_create_expense_claim- Create receipt + expense claimxero_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 toolsxero_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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Connect Xero to AI agents with secure read or write access across multiple organisations.
Query and export Xero finance data and prepare accounting drafts in your xpnAI Workspace.
Connect CollectiveSpend with Xero to manage contacts. Retrieve, create, and update contact records…
Invoicing, expenses, accounting analytics. OAuth 2.1 dynamic client registration, no API key.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.201Apache 2.0
- AlicenseAqualityCmaintenanceEnables natural language interaction with Xero accounting data, managing contacts, invoices, and accounts across multiple organisations via OAuth2.12MIT
- FlicenseNot gradedqualityBmaintenanceEnables accountants to connect Xero, read accounting data, analyze, and execute controlled draft operations after explicit confirmation, with Xero as the source of truth.-
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT