Summary
Connects Claude to the Xero Accounting API for managing customers, suppliers, invoices, payments, and pulling financial reports. You get domain-organized tools for contacts, invoices, payments, accounts, and reports including P&L, balance sheet, and aged receivables. Supports both stdio for local Claude Desktop use and HTTP mode for multi-tenant deployments. Ships with gateway mode that accepts per-request credentials via headers, useful if you're building a proxy that handles OAuth tokens for multiple Xero organizations. Requires a Xero developer account and OAuth2 credentials. Reach for this when you need Claude to read or write accounting data directly instead of exporting CSV files.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
40 tools
XERO_CREATE_BANK_TRANSACTIONCreate a bank transaction in Xero. Use SPEND for payments out or RECEIVE for money received.9 params
Create a bank transaction in Xero. Use SPEND for payments out or RECEIVE for money received.
Parameters* required
BankAccountCodestringBank account code (from chart of accounts).
ContactIDstringXero Contact ID for the transaction.
CurrencyCodestringCurrency code (e.g., USD, EUR).
DatestringTransaction date in YYYY-MM-DD format.
LineItemsarrayList of line items for the bank transaction.
ReferencestringReference or transaction description.
StatusstringTransaction status: AUTHORISED or DELETED.
TypestringTransaction type: SPEND (payment out) or RECEIVE (money in).
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_CREATE_CONTACTCreate a new contact in Xero. Contacts can be customers, suppliers, or both.14 params
Create a new contact in Xero. Contacts can be customers, suppliers, or both.
Parameters* required
AccountNumberstringAccount reference number for the contact.
BankAccountDetailsstringBank account details for the contact.
DefaultCurrencystringDefault currency code (e.g., USD, EUR).
EmailAddressstringEmail address of the contact.
FirstNamestringFirst name of the contact person.
IsCustomerbooleanMark as customer when true.
IsSupplierbooleanMark as supplier when true.
LastNamestringLast name of the contact person.
NamestringFull name of the contact or organization.
TaxNumberstringTax number (VAT/ABN/GST number).
WebsitestringWebsite URL of the contact.
mobile_numberstringMobile phone number (will be added as MOBILE phone type).
phone_numberstringPrimary phone number (will be added as DEFAULT phone type).
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_CREATE_INVOICECreate a new invoice in Xero. Supports both sales invoices (ACCREC) and bills (ACCPAY).10 params
Create a new invoice in Xero. Supports both sales invoices (ACCREC) and bills (ACCPAY).
Parameters* required
ContactIDstringXero Contact ID for the invoice.
CurrencyCodestringCurrency code (e.g., USD, EUR).
DatestringInvoice date in YYYY-MM-DD format.
DueDatestringDue date in YYYY-MM-DD format.
InvoiceNumberstringInvoice number (auto-generated if not provided).
LineItemsarrayList of line items for the invoice.
ReferencestringReference or purchase order number.
StatusstringInvoice status: DRAFT, SUBMITTED, or AUTHORISED.
TypestringInvoice type: ACCREC (accounts receivable/sales) or ACCPAY (accounts payable/bills).
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_CREATE_ITEMCreate an inventory item in Xero. Items can be tracked for sales and/or purchases.9 params
Create an inventory item in Xero. Items can be tracked for sales and/or purchases.
Parameters* required
CodestringUnique item code (SKU).
IsPurchasedbooleanItem can be purchased when true.
IsSoldbooleanItem can be sold when true.
NamestringItem name/description.
PurchaseDetails.AccountCodestringAccount code for purchases.
PurchaseDetails.UnitPricenumberUnit price for purchases.
SalesDetails.AccountCodestringAccount code for sales.
SalesDetails.UnitPricenumberUnit price for sales.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_CREATE_PAYMENTCreate a payment in Xero to link an invoice with a bank account transaction.7 params
Create a payment in Xero to link an invoice with a bank account transaction.
Parameters* required
AccountIDstringXero Account ID (bank account) for the payment.
AmountnumberPayment amount.
CurrencyRatenumberExchange rate for foreign currency payments.
DatestringPayment date in YYYY-MM-DD format.
InvoiceIDstringXero Invoice ID that this payment is for.
ReferencestringPayment reference or description.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_CREATE_PURCHASE_ORDERCreate a purchase order in Xero to order goods/services from suppliers.7 params
Create a purchase order in Xero to order goods/services from suppliers.
Parameters* required
ContactIDstringXero Contact ID for the purchase order.
DatestringPurchase order date in YYYY-MM-DD format.
DeliveryDatestringExpected delivery date in YYYY-MM-DD format.
LineItemsarrayList of line items for the purchase order.
ReferencestringReference or purchase order number.
StatusstringPurchase order status: DRAFT, SUBMITTED, AUTHORISED, BILLED.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_ACCOUNTRetrieve a specific account from the chart of accounts by ID. Returns account code, name, type, and settings.2 params
Retrieve a specific account from the chart of accounts by ID. Returns account code, name, type, and settings.
Parameters* required
account_idstringXero Account ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_ASSETRetrieve a specific asset by ID from Xero. Returns depreciation details and book value.2 params
Retrieve a specific asset by ID from Xero. Returns depreciation details and book value.
Parameters* required
asset_idstringXero Asset ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_BALANCE_SHEET_REPORTRetrieve Balance Sheet report from Xero. Shows assets, liabilities, and equity at a specific date.7 params
Retrieve Balance Sheet report from Xero. Shows assets, liabilities, and equity at a specific date.
Parameters* required
datestringBalance sheet as of this date in YYYY-MM-DD format.
paymentsOnlybooleanShow only cash transactions when true (cash basis).
periodsintegerNumber of periods to compare.
standardLayoutbooleanUse standard layout when true.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
timeframestringTimeframe period: MONTH, QUARTER, or YEAR.
trackingOptionIDstringFilter by tracking option ID.
XERO_GET_BUDGETRetrieve a budget from Xero. Budgets track planned vs actual spending by account.4 params
Retrieve a budget from Xero. Budgets track planned vs actual spending by account.
Parameters* required
DateFromstringStart date for budget data in YYYY-MM-DD format.
DateTostringEnd date for budget data in YYYY-MM-DD format.
budget_idstringXero Budget ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_CONNECTIONSTool to list active Xero connections. Use when you need to retrieve all current tenant connections for the authenticated user.
Tool to list active Xero connections. Use when you need to retrieve all current tenant connections for the authenticated user.
No parameter schema in public metadata yet.
XERO_GET_CONTACTRetrieve a specific contact by ID from Xero. Returns full contact details including addresses and phone numbers.2 params
Retrieve a specific contact by ID from Xero. Returns full contact details including addresses and phone numbers.
Parameters* required
contact_idstringXero Contact ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_CONTACTSTool to retrieve a list of contacts. Use when you need up-to-date contact information with filtering, paging, or incremental updates.10 params
Tool to retrieve a list of contacts. Use when you need up-to-date contact information with filtering, paging, or incremental updates.
Parameters* required
ContactIDstringXero ContactID. If provided, fetches a single contact at /Contacts/{ContactID}.
IDsarrayComma-separated list of ContactIDs to filter by.
If-Modified-SincestringUTC timestamp (YYYY-MM-DDThh:mm:ss) to set as the If-Modified-Since header; returns only contacts created or modified since this timestamp.
includeArchivedbooleanInclude archived contacts when true.
orderstringSort by field, e.g. UpdatedDateUTC DESC.
pageintegerPage number for paginated results (requires pageSize).
pageSizeintegerNumber of contacts per page (requires page).
searchTermstringCase-insensitive search across Name, FirstName, LastName, ContactNumber, CompanyNumber, EmailAddress.
summaryOnlybooleanReturn a lightweight summary-only response when true.
wherestringOData-style filter on optimised fields, e.g. Name="ABC".
XERO_GET_INVOICERetrieve a specific invoice by ID from Xero. Returns full invoice details including line items and status.3 params
Retrieve a specific invoice by ID from Xero. Returns full invoice details including line items and status.
Parameters* required
invoice_idstringXero Invoice ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
unitdpintegerNumber of decimal places for unit amounts (default 4).
XERO_GET_ITEMRetrieve a specific item by ID from Xero. Returns item code, name, pricing, and tax details.2 params
Retrieve a specific item by ID from Xero. Returns item code, name, pricing, and tax details.
Parameters* required
item_idstringXero Item ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_MANUAL_JOURNALRetrieve a specific manual journal by ID from Xero. Returns full details including journal lines.2 params
Retrieve a specific manual journal by ID from Xero. Returns full details including journal lines.
Parameters* required
manual_journal_idstringXero Manual Journal ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_ORGANISATIONRetrieve organisation details from Xero. Returns company info, base currency, timezone, financial year settings, etc.1 params
Retrieve organisation details from Xero. Returns company info, base currency, timezone, financial year settings, etc.
Parameters* required
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_PROFIT_LOSS_REPORTRetrieve Profit & Loss report from Xero. Shows income, expenses, and net profit for a specified period.11 params
Retrieve Profit & Loss report from Xero. Shows income, expenses, and net profit for a specified period.
Parameters* required
fromDatestringStart date for the report in YYYY-MM-DD format.
paymentsOnlybooleanShow only cash transactions when true (cash basis).
periodsintegerNumber of periods to compare (e.g., for month-on-month comparison).
standardLayoutbooleanUse standard layout when true.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
timeframestringTimeframe period: MONTH, QUARTER, or YEAR.
toDatestringEnd date for the report in YYYY-MM-DD format.
trackingCategoryIDstringFilter by tracking category ID.
trackingCategoryID2stringFilter by second tracking category ID.
trackingOptionIDstringFilter by tracking option ID.
trackingOptionID2stringFilter by second tracking option ID.
XERO_GET_PROJECTRetrieve a specific project by ID from Xero. Returns project details, deadlines, and status.2 params
Retrieve a specific project by ID from Xero. Returns project details, deadlines, and status.
Parameters* required
project_idstringXero Project ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_PURCHASE_ORDERRetrieve a specific purchase order by ID from Xero. Returns full details including line items and status.2 params
Retrieve a specific purchase order by ID from Xero. Returns full details including line items and status.
Parameters* required
purchase_order_idstringXero Purchase Order ID to retrieve.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_GET_QUOTESTool to retrieve a list of quotes. Use when you need to list, filter, or page through sales quotes. Use after obtaining the tenant ID via connections.11 params
Tool to retrieve a list of quotes. Use when you need to list, filter, or page through sales quotes. Use after obtaining the tenant ID via connections.
Parameters* required
ContactIDstringFilter for quotes belonging to a particular contact by ContactID.
DateFromstringFilter for quotes on or after this date (YYYY-MM-DD).
DateTostringFilter for quotes on or before this date (YYYY-MM-DD).
ExpiryDateFromstringFilter for quotes expiring on or after this date (YYYY-MM-DD).
ExpiryDateTostringFilter for quotes expiring on or before this date (YYYY-MM-DD).
If-Modified-SincestringOnly return quotes modified after this UTC timestamp in RFC3339 format.
QuoteNumberstringFilter by quote number.
StatusstringFilter for quotes of a particular status.
orderstringOrder by any element, e.g., ExpiryDate ASC.
pageintegerPage number for paginated results (1-based).
tenant_idstringXero Tenant ID. Optional - will auto-fetch from connections if not provided.
XERO_LIST_ACCOUNTSRetrieve chart of accounts from Xero. Returns all accounting codes used for categorizing transactions.3 params
Retrieve chart of accounts from Xero. Returns all accounting codes used for categorizing transactions.
Parameters* required
orderstringSort by field, e.g. Code ASC or Name DESC.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="ACTIVE" AND Type=="EXPENSE"
XERO_LIST_ASSETSRetrieve fixed assets from Xero. Assets track depreciation and book value of capital equipment.6 params
Retrieve fixed assets from Xero. Assets track depreciation and book value of capital equipment.
Parameters* required
orderBystringSort field: AssetName, AssetNumber, PurchaseDate.
pageintegerPage number for paginated results.
pageSizeintegerNumber of assets per page.
sortDirectionstringSort direction: ASC or DESC.
statusstringFilter by asset status: DRAFT, REGISTERED, DISPOSED.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_ATTACHMENTSList all attachments for a specific entity in Xero (invoice, contact, etc.).3 params
List all attachments for a specific entity in Xero (invoice, contact, etc.).
Parameters* required
entity_idstringID of the entity to list attachments for.
entity_typestringEntity type: Invoices, Contacts, BankTransactions, CreditNotes, PurchaseOrders, etc.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_BANK_TRANSACTIONSRetrieve bank transactions from Xero. Includes spend (payments) and receive (receipts) transactions.6 params
Retrieve bank transactions from Xero. Includes spend (payments) and receive (receipts) transactions.
Parameters* required
If-Modified-SincestringUTC timestamp to return only bank transactions modified since this date.
orderstringSort by field, e.g. Date DESC or UpdatedDateUTC ASC.
pageintegerPage number for paginated results.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
unitdpintegerDecimal places for unit amounts (default 4).
wherestringOData-style filter, e.g. Status=="AUTHORISED" AND Type=="SPEND"
XERO_LIST_CREDIT_NOTESRetrieve list of credit notes from Xero. Credit notes are issued to reduce amounts owed by customers.5 params
Retrieve list of credit notes from Xero. Credit notes are issued to reduce amounts owed by customers.
Parameters* required
If-Modified-SincestringUTC timestamp to return only credit notes modified since this date.
orderstringSort by field, e.g. Date DESC or CreditNoteNumber ASC.
pageintegerPage number for paginated results.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="AUTHORISED"
XERO_LIST_FILESRetrieve files from Xero Files. Lists documents stored in Xero's file management system.5 params
Retrieve files from Xero Files. Lists documents stored in Xero's file management system.
Parameters* required
folderIdstringFilter files by folder ID.
pageintegerPage number for paginated results.
pagesizeintegerNumber of files per page (max 100).
sortstringSort field: Name, Size, CreatedDateUTC.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_FOLDERSRetrieve folders from Xero Files. Lists document folders in Xero's file management system.2 params
Retrieve folders from Xero Files. Lists document folders in Xero's file management system.
Parameters* required
sortstringSort field: Name, CreatedDateUTC.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_INVOICESRetrieve a list of invoices from Xero. Supports filtering by status, contact, date range, and pagination.10 params
Retrieve a list of invoices from Xero. Supports filtering by status, contact, date range, and pagination.
Parameters* required
ContactIDsstringComma-separated list of Contact IDs to filter invoices by contact.
If-Modified-SincestringUTC timestamp to return only invoices modified since this date.
InvoiceIDsstringComma-separated list of Invoice IDs to filter by.
StatusesstringComma-separated list of invoice statuses to filter by (e.g., DRAFT, SUBMITTED, AUTHORISED, PAID).
createdByMyAppbooleanFilter to invoices created by your app when true.
includeArchivedbooleanInclude archived invoices when true.
orderstringSort by field, e.g. Date DESC or InvoiceNumber ASC.
pageintegerPage number for paginated results.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="AUTHORISED" AND Total>100
XERO_LIST_ITEMSRetrieve items (inventory/products) from Xero. Items can be tracked for sales and/or purchases.4 params
Retrieve items (inventory/products) from Xero. Items can be tracked for sales and/or purchases.
Parameters* required
orderstringSort by field, e.g. Code ASC or Name DESC.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
unitdpintegerNumber of decimal places for unit amounts (default 4).
wherestringOData-style filter, e.g. IsSold==true AND IsPurchased==true
XERO_LIST_JOURNALSRetrieve journals from Xero. Journals show the accounting entries for all transactions.4 params
Retrieve journals from Xero. Journals show the accounting entries for all transactions.
Parameters* required
If-Modified-SincestringUTC timestamp to return only journals modified since this date.
offsetintegerOffset for pagination.
paymentsOnlybooleanFilter to payment journals only when true.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_MANUAL_JOURNALSRetrieve manual journals from Xero. Manual journals are used for period-end adjustments and corrections.5 params
Retrieve manual journals from Xero. Manual journals are used for period-end adjustments and corrections.
Parameters* required
If-Modified-SincestringUTC timestamp to return only manual journals modified since this date.
orderstringSort by field, e.g. Date DESC.
pageintegerPage number for paginated results.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="POSTED"
XERO_LIST_PAYMENTSRetrieve list of payments from Xero. Payments link invoices to bank transactions.5 params
Retrieve list of payments from Xero. Payments link invoices to bank transactions.
Parameters* required
If-Modified-SincestringUTC timestamp to return only payments modified since this date.
orderstringSort by field, e.g. Date DESC or Amount ASC.
pageintegerPage number for paginated results.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="AUTHORISED"
XERO_LIST_PROJECTSRetrieve projects from Xero. Projects track time and costs for client work.6 params
Retrieve projects from Xero. Projects track time and costs for client work.
Parameters* required
contactIDstringFilter projects by contact ID.
pageintegerPage number for paginated results.
pageSizeintegerNumber of projects per page.
projectIdsstringComma-separated list of project IDs to filter by.
statesstringComma-separated project states: INPROGRESS, CLOSED.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_PURCHASE_ORDERSRetrieve list of purchase orders from Xero. Purchase orders track goods/services ordered from suppliers.7 params
Retrieve list of purchase orders from Xero. Purchase orders track goods/services ordered from suppliers.
Parameters* required
DateFromstringFilter by date from (YYYY-MM-DD).
DateTostringFilter by date to (YYYY-MM-DD).
If-Modified-SincestringUTC timestamp to return only purchase orders modified since this date.
StatusstringFilter by status: DRAFT, SUBMITTED, AUTHORISED, BILLED, DELETED.
orderstringSort by field, e.g. Date DESC or PurchaseOrderNumber ASC.
pageintegerPage number for paginated results.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_LIST_TAX_RATESRetrieve tax rates from Xero. Shows available tax codes and rates for the organization.4 params
Retrieve tax rates from Xero. Shows available tax codes and rates for the organization.
Parameters* required
TaxTypestringFilter by specific tax type.
orderstringSort by field, e.g. Name ASC.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="ACTIVE"
XERO_LIST_TRACKING_CATEGORIESRetrieve tracking categories from Xero. Tracking categories are used to segment data for reporting (e.g., departments, regions).4 params
Retrieve tracking categories from Xero. Tracking categories are used to segment data for reporting (e.g., departments, regions).
Parameters* required
includeArchivedbooleanInclude archived tracking categories when true.
orderstringSort by field, e.g. Name ASC.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
wherestringOData-style filter, e.g. Status=="ACTIVE"
XERO_POST_INVOICE_UPDATETool to update an existing invoice. Use when you need to modify the details of an invoice after it's been created.4 params
Tool to update an existing invoice. Use when you need to modify the details of an invoice after it's been created.
Parameters* required
InvoiceIDstringUnique identifier (UUID) of the invoice.
InvoiceNumberstringInvoice number identifier.
InvoicesarrayList containing invoice update definitions (one item).
unitdpintegerNumber of decimal places for unit amounts.
XERO_UPDATE_CONTACTUpdate an existing contact in Xero. Only provided fields will be updated.12 params
Update an existing contact in Xero. Only provided fields will be updated.
Parameters* required
AccountNumberstringAccount reference number for the contact.
BankAccountDetailsstringBank account details for the contact.
DefaultCurrencystringDefault currency code (e.g., USD, EUR).
EmailAddressstringEmail address of the contact.
FirstNamestringFirst name of the contact person.
LastNamestringLast name of the contact person.
NamestringFull name of the contact or organization.
TaxNumberstringTax number (VAT/ABN/GST number).
contact_idstringXero Contact ID to update.
mobile_numberstringMobile phone number (will update MOBILE phone type).
phone_numberstringPrimary phone number (will update DEFAULT phone type).
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
XERO_UPLOAD_ATTACHMENTUpload a file attachment to a Xero entity (invoice, contact, etc.). Supports PDF, images, and documents.6 params
Upload a file attachment to a Xero entity (invoice, contact, etc.). Supports PDF, images, and documents.
Parameters* required
entity_idstringID of the entity to attach the file to.
entity_typestringEntity type to attach to: Invoices, Contacts, BankTransactions, CreditNotes, etc.
file_to_uploadstringFile to upload as attachment.
filenamestringFilename for the attachment.
include_onlinebooleanInclude online invoice in attachment.
tenant_idstringXero tenant/organization ID. If not provided, uses the first connected tenant.
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.
Features
- Contacts, invoices, payments, chart of accounts, and financial reports over stdio, HTTP, or Cloudflare Workers transports
- Interactive invoice card (MCP Apps, SEP-1865):
xero_invoices_getrenders as a rich, read-only card in MCP Apps hosts — neutral by default, brandable viawindow.__BRAND__injection orMCP_BRAND_*env vars - Gateway mode for per-request, multi-tenant credentials
One-Click Deployment
Note on registry auth: This server depends only on public npm packages, so the Cloudflare and DigitalOcean cloud builders install its dependencies anonymously — no token is required for one-click deploy. (If a future release adds a private
@wyre-ai/*dependency, you would supply a GitHub PAT withread:packagesas a build variable —NODE_AUTH_TOKENfor Cloudflare Workers, a build-timeGITHUB_TOKENsecret for DigitalOcean.)Installing the published package: The released package is published to the GitHub Packages npm registry, which requires authentication on every install (even for public packages). To install it, authenticate npm to
npm.pkg.github.comwith a GitHub PAT that hasread:packages:export NODE_AUTH_TOKEN=$(gh auth token) npm install @wyre-ai/xero-mcp
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 tokenX-Xero-Tenant-Id— Xero tenant ID
This allows a gateway/proxy to manage multi-tenant credentials.
Interactive Invoice Card (MCP Apps)
xero_invoices_get renders as an interactive card in MCP Apps hosts
(Claude Desktop/web) showing status, contact, dates, amounts, and line
items; plain-JSON behavior is unchanged in other hosts. The card is
read-only — invoices are financial records, so no write actions are
exposed from it. It is neutral by default and brandable via
window.__BRAND__ injection or MCP_BRAND_* env vars (MCP_BRAND_NAME,
MCP_BRAND_LOGO_URL, MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR,
MCP_BRAND_BG, MCP_BRAND_TEXT) — no rebuild needed.
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 filteringxero_contacts_get— Get detailed contact information by IDxero_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 filtersxero_invoices_get— Get detailed invoice information by IDxero_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 filterxero_payments_get— Get detailed payment information by IDxero_payments_create— Record a payment against an invoice
Accounts
xero_accounts_list— List chart of accounts with optional type/class filterxero_accounts_get— Get detailed account information by ID
Reports
xero_reports_profit_and_loss— Profit and Loss (income statement) for a date rangexero_reports_balance_sheet— Balance Sheet as of a specific datexero_reports_aged_receivables— Aged Receivables by contactxero_reports_aged_payables— Aged Payables by contact
License
Apache-2.0
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
XERO_TENANT_ID*Xero tenant ID (organisation). Required when AUTH_MODE is 'env'.
XERO_ACCESS_TOKEN*secretXero OAuth2 access token. Required when AUTH_MODE is 'env'.
MCP_TRANSPORTdefault: stdioTransport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
AUTH_MODEdefault: envCredential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.
LOG_LEVELdefault: infoLog verbosity: debug, info, warn, error
Categories
Registryactive
Packageghcr.io/wyre-technology/xero-mcp:v1.4.0
TransportSTDIO
AuthRequired
UpdatedJun 2, 2026
