Xero AP and Expenses MCP server ​

The Xero AP and Expenses MCP server enables LLMs to interact with Xero for the accounts-payable side of the ledger through natural conversation. It provides tools to create and manage supplier bills and import batches of spend-money expenses, without requiring direct interaction with the Xero interface.

Uses ​

Use the Xero AP and Expenses MCP server to perform the following actions:

• Discover the Xero organizations associated with the connected account before you target a write.
• Create and approve supplier bills for payment queues.
• Approve draft supplier bills, including drafts that arrived through Hubdoc.
• Void duplicate or erroneous approved bills after explicit confirmation.
• Import batches of spend-money expenses through a preview-then-commit safety check.
• Resolve a bill or supplier contact before approving, voiding, or creating a bill.

Example prompts ​

Use the following example prompts to invoke Xero AP and Expenses MCP server tools:

• Which Xero organizations are connected to this account?
• Enter a supplier bill from Acme Corp for $2,400, already approved for payment.
• Bill our facilities account for this month's rent from Acme Corp, already approved.
• Approve the draft bill from Acme Corp due September 15.
• Void the duplicate bill I created for Acme Corp yesterday.
• Import this batch of card expenses and flag any duplicates before posting.
• Check whether this bill has any payments applied before I void it.
• Find the contact record for Acme Corp.

Xero AP and Expenses MCP server tools ​

The Xero AP and Expenses MCP server provides the following tools:

Install the Xero AP and Expenses MCP server ​

Complete the following steps to install a prebuilt MCP server to your project:

Xero AP and Expenses connection setup ​

How to use Xero AP and Expenses MCP server tools ​

Refer to the following sections for detailed information on available tools:

list_organizations tool ​

The list_organizations tool lists the Xero organizations available to the connected account, each with its Tenant ID, name, and type. Your LLM uses this tool to discover or disambiguate the target organization before any write when more than one organization may be connected.

Try asking:

• Which Xero organizations are connected to this account?
• Show me the Tenant ID for our UK entity.
• List every Xero organization I can act on.

create_bill tool ​

The create_bill tool creates a new supplier bill directly in approved status in a chosen Xero organization, with a known supplier contact and line items. Your LLM uses this tool to enter a bill and immediately queue it for payment. The tool uses an account code that already exists in the organization's chart of accounts instead of creating a new one.

Try asking:

• Enter a supplier bill from Acme Corp for $2,400, already approved for payment.
• Bill our facilities account for this month's rent from Acme Corp.
• Record an approved bill for 10 hours of contractor work at $150 an hour.

authorize_bill tool ​

The authorize_bill tool approves an existing draft supplier bill, including drafts that arrived through Hubdoc, and sets its status to AUTHORISED. You must supply a due date. Your LLM uses this tool to approve a bill without changing its contents.

Try asking:

• Approve the draft bill from Acme Corp due September 15.
• Authorize the Hubdoc bill that's still in draft due by the end of the month.
• Approve bill 7e11f003-5c8f-47be-465b-83f9649a13d0 due in thirty days.

void_bill tool ​

The void_bill tool irreversibly voids a supplier bill after your explicit confirmation. Your LLM uses this tool to void a specific bill.

Try asking:

• Void the duplicate bill I created for Acme Corp yesterday.
• Cancel this bill, it was entered by mistake.
• Yes, void that bill, I'm sure it's a duplicate.

import_expenses tool ​

The import_expenses tool imports a batch of spend-money expenses through a preview-then-commit flow, validates every item, and flags suspected duplicates before anything posts. Your LLM uses this tool to preview the batch, show you the results, and commit only after you confirm.

Try asking:

• Import this batch of card expenses and flag any duplicates before posting.
• Preview these spend-money transactions before we post them.
• Commit the previewed expense batch now, everything looks right.

resolve_bill tool ​

The resolve_bill tool looks up one bill's write-gate preconditions, including its status, outstanding amount, payments, and credit allocations. Your LLM uses this tool immediately before approving or voiding a bill, or to convert a bill number you gave it into a bill ID.

Try asking:

• Check whether this bill has any payments applied before I void it.
• Look up the status of bill INV-0042 before I approve it.
• Does this bill have any credit notes allocated against it?

resolve_supplier_contact tool ​

The resolve_supplier_contact tool resolves a supplier name to a contact ID by exact match only, and never creates a new contact. Your LLM uses this tool immediately before creating a bill when you've given it a supplier name rather than a contact ID.

Try asking:

• Find the contact record for Acme Corp.
• Look up the supplier contact for Acme Corp before I bill them.
• Is Acme Corp already set up as a supplier in this organization?

Getting started ​

View and manage your MCP server tools in the Overview page Tools section. Tool management provides the following capabilities:

• Start tools
• Remove tools
• Edit tools
• Add tools
• Edit your LLM-facing MCP server description