DeepLedger
Menu

Connect an agent

Xero MCP in Australia: The Ultimate Guide for Firms (2026)

Use Claude, ChatGPT or Grok in Australian Xero organisations: setup, GST tax codes, BAS-period reports, prompts, every tool and the limits.

Published by DeepLedger22 min read

A Xero MCP server lets an AI app such as Claude, ChatGPT, Cursor or Grok read and work in your Australian Xero organisations. DeepLedger is a hosted Xero MCP server: you connect each organisation once, add one address to your AI app, and the AI works in Australian dollars with your organisation's own GST tax codes, saving new invoices, bills and journals as drafts by default.

This is the Australian edition of our Xero MCP server guide. It is written for accounting firms, bookkeepers, BAS agents and in-house finance teams in Australia. It covers setup, how GST tax codes work when the AI records a transaction, which reports to run for a BAS period, prompts that work, every Xero tool DeepLedger offers today, and what it does not do.

The tools below are built and tested. If Connect to Xero is not offered on your company's Connections tab, contact us.

Amounts in this guide are in Australian dollars. DeepLedger's own prices are in US dollars.

What is a Xero MCP server, in plain words?

MCP stands for Model Context Protocol. It is a shared standard that lets an AI app plug into another system. Your AI app sits on one end, your Xero organisation on the other, and the MCP server sits in the middle.

The server offers the AI a set of tools, each a specific job: "run the profit and loss", "find a contact", "create a bill". You ask in plain English, the AI picks the tools, the server runs them through Xero's API, and the AI explains the result.

For an Australian practice, three things follow:

  • The server decides what the AI can do. If a server has no tool for lodging a BAS, no prompt makes the AI lodge one. DeepLedger has no lodging tool.
  • GST is in the data, not the protocol. MCP knows nothing about GST. The tax codes come from your Xero organisation, so the AI is only as right as the codes it reads and the rules you give it.
  • Xero's own limits always apply. Every Xero MCP server uses Xero's API underneath, with Xero's permissions and rate limits.

The Xero MCP server guide compares the main ways to connect Xero to an AI app. This guide assumes you have chosen a hosted harness and want it to work for Australian books.

What can DeepLedger's Xero MCP do today?

DeepLedger offers these Xero tools, plus its workflow tools for Tasks, AI Brain, month-end close, reconciliation and documents. The examples use Australian businesses and GST.

AreaWhat the AI can doAustralian example
OrganisationsList your companies, switch between them, read the settings"Switch to Coastal Joinery and tell me its GST basis and tax period"
Master dataRead and maintain accounts, contacts, items; read tax rates, bank accounts, currencies"Does this supplier have an ABN recorded in Xero?"
Sales invoicesCreate, update, approve, void, email, payment linkA draft invoice for $3,300 including GST
Bills and purchase ordersCreate, update, approve, void bills; create purchase orders and convert an approved one to a billA supplier bill coded to GST on Expenses
QuotesCreate, update, convert an accepted quote to an invoiceConvert an accepted fit-out quote
Repeating invoicesList, create, delete templatesA monthly retainer of $1,100 including GST
Credit notesCreate, void, allocate to an invoice or billCredit $220 against an open invoice
PaymentsRecord or reverse a payment; allocate or refund an overpayment or prepayment; read batch paymentsMark a bill paid from the business transaction account
Spend and receive moneyRecord bank transactions with no invoice or bill behind themA card purchase of fuel with GST
TransfersMove money between your own accountsTransfer to the tax savings account
BankingRead each bank account's balances and unreconciled itemsUnreconciled items at 30 September
Manual journalsDraft, post or void balanced journalsA 30 June accrual, saved as a draft
Tracking categoriesList and maintain categories and optionsSplit results by Sydney and Melbourne
Transaction searchSearch twelve transaction types with filtersEvery bill in the September quarter
ReportsProfit and loss, balance sheet, trial balance, aged receivables and payables, bank summary, executive summary, budget against actualThe September quarter's profit and loss on a cash basis

The tool reference below explains each one, with what it will and will not do.

How do I set up Xero MCP for an Australian practice?

Before you start

  • A DeepLedger account. The 14-day trial needs no credit card.
  • Permission to connect the client's Xero organisation, so you can approve DeepLedger on Xero's own sign-in page.
  • An AI app that can add a remote MCP server as a custom connector: Claude, ChatGPT, Cursor, Grok, Microsoft Copilot Studio or Gemini.

Step 1: Connect Xero to DeepLedger

In the portal, open Companies, choose the company (or Add company and pick Xero), and open its Connections tab. Under Accounting software, choose Connect to Xero, sign in with Xero and pick the organisation. DeepLedger never sees your Xero password.

Step 2: Copy the MCP address

Open Connect AI agent in the portal's top bar, or copy it from here:

https://mcp.deepledger.ai/mcp

The same address serves QuickBooks Online, so a firm with clients on both ledgers adds it once.

Step 3: Add it to your AI app and check the organisation

Add the address as a custom connector in your AI app. When the sign-in window opens, sign in with your DeepLedger account, not your Xero login, and allow access. Then ask:

Which Xero organisation am I in? Show its base currency, GST basis, tax period, financial year end and lock dates.

The answer should show AUD, your GST basis (cash or accruals), your BAS period (for example quarterly), a 30 June year end and any lock dates. If the organisation or settings look wrong, stop and switch before any work.

Each AI app has its own menus. Follow the full guide for yours:

How do GST tax codes work when the AI records a transaction?

Every line on a Xero invoice, bill, credit note or bank transaction carries a tax rate. The AI does not pick one from memory. DeepLedger tells the AI to read the account codes and tax codes from your Xero organisation first, and a line with no tax code takes the account's default.

These are the Australian tax types in Xero's API. The names are the ones Xero shows on a standard Australian organisation:

Xero tax codeName in XeroRateTypical use
OUTPUTGST on Income10%Taxable sales
INPUTGST on Expenses10%Purchases that include GST
EXEMPTOUTPUTGST Free Income0%GST-free sales
EXEMPTEXPENSESGST Free Expenses0%GST-free purchases
CAPEXINPUTGST on Capital10%Capital purchases that include GST
EXEMPTCAPITALGST Free Capital0%GST-free capital purchases
EXEMPTEXPORTGST Free Exports0%Exports
INPUTTAXEDInput Taxed0%Input-taxed sales and purchases
BASEXCLUDEDBAS Excluded0%Amounts that do not belong on the BAS at all
GSTONIMPORTSGST on Imports0% (system rate)A line that is all GST, such as GST paid to Customs on imported goods
GSTONCAPIMPORTSGST on Capital Imports0% (system rate)A line that is all GST on imported capital goods

Source: Xero's accounting API specification (the TaxType list) and Xero's tax types.

Your organisation may also have custom rates. Ask the AI to list them before your first coding job:

List the active tax rates in this organisation with their codes and rates.

Inclusive or exclusive amounts

Australian invoices and receipts usually show prices including GST. Tell the AI which way round your amounts are. For example, a supplier bill for $1,650 including GST, coded to GST on Expenses, is $1,500 plus $150 GST. The same $1,650 entered as exclusive would become $1,650 plus $165 GST.

If a request does not say, DeepLedger uses the contact's default, then the organisation's, and the result says which it used. Check that line in the answer before you approve anything.

Create a draft bill from Coastal Timber for $1,650 including GST, dated 14 October, coded to Materials with GST on Expenses. Their invoice number is CT-2291.

Rules per client

Keep GST rules where the AI can read them: in each company's AI Brain. For example, "Coastal Timber always charges GST", "Code council rates to GST Free Expenses", or "This client reports GST on a cash basis, quarterly". Ask the AI to read the company's AI Brain and skills before it codes anything.

Which reports can I run for a BAS period?

DeepLedger reads Xero's financial reports, which are useful working papers for a BAS period. It does not read Xero's Activity Statement or its GST Calculation Worksheet, and it does not lodge.

Most small businesses report GST quarterly. The ATO's standard quarterly due dates are below; lodging online or through a registered agent can give extra time.

QuarterMonthsStandard due date
1July, August, September28 October
2October, November, December28 February
3January, February, March28 April
4April, May, June28 July

Source: ATO, due dates for lodging and paying your BAS.

Reports and searches that help with a quarter:

  • Profit and loss for the quarter, on the basis your organisation reports GST. Ask for cash basis when the organisation is on cash: DeepLedger runs the report on payments only.
  • Every transaction in the quarter by tax code: the AI searches invoices, bills, credit notes and bank transactions for the dates, and each row carries its lines with account and tax codes.
  • Open invoices and bills at quarter end: the full outstanding list, checked against the receivables and payables accounts. Xero's aged receivables and payables reports run one contact at a time.
  • Trial balance at quarter end, to tie the GST account to what you expect.
  • Bank summary and unreconciled items, so you know what is not yet recorded before you rely on the figures.

For the September quarter (1 July to 30 September), run the profit and loss on a cash basis, then list every bill and spend money line coded GST Free Expenses or BAS Excluded over $500. Group them by supplier.

For a full step-by-step review, read how to review GST before your BAS in Xero. Compare the AI's figures with the Activity Statement in Xero before you lodge.

Prompts that work for Australian books

Name the organisation, the dates and, for reports, cash or accruals. Start with a report you can check in Xero, then move to drafts.

Code transactions

In Harbourside Cafe, list last month's spend money transactions coded to General Expenses. Suggest an account and tax code for each from how the supplier was coded before, and open a task for any you are unsure of.

Enter supplier bills

Here are three supplier invoices (attached). Check none is already in Xero, then create them as draft bills with GST on Expenses where the invoice shows GST, and attach each file.

Invoice a customer

Create a draft invoice to Seaview Builders for 30 hours of joinery at $110 an hour plus GST, due in 14 days. Do not send it.

Chase receivables

List every open sales invoice more than 30 days overdue, with contact, amount and due date. Draft a short reminder for each. Do not send anything.

Prepare a reconciliation

Prepare the September reconciliation for the business transaction account. The statement closing balance is $48,215.60. List the Xero transactions that should match, anything missing and any likely duplicates.

Close the financial year

It is 30 June. Draft accrual journals for the electricity and accounting fees we have not been billed for yet, using last quarter's bills as a guide. Save them as drafts for my review.

Compare clients

For each of my Xero companies, show cash at bank, this month's revenue, overdue receivables and open Tasks in one table.

What does each Xero tool do?

Your AI app shows these tool names when it calls them. Every tool works in the active company, and every result names that company.

xeroOrganisation: choose the company

Lists your companies, switches the active one by name or id, and reads the organisation's settings: base currency, GST basis, tax period, tax defaults, ABN, financial year end and lock dates. The active company is shared by all your AI apps, so confirm it before each piece of work. Dates such as "today" follow the organisation's own time zone, so a Perth client and a Sydney client each get their own date.

xeroMasterData: accounts, contacts, items and tax rates

Reads the chart of accounts, bank accounts, contacts (searchable by name, email or account number), items, tax rates, tracking categories, currencies, contact groups and branding themes. It creates and updates accounts, contacts and items, and archives accounts and contacts. A contact can carry its ABN in Xero's tax number field. Xero refuses duplicate contact names, so the AI searches before creating one.

xeroInvoice: sales invoices

Gets, creates, updates, approves, voids and deletes sales invoices, and can email one through Xero or give its online payment link. New invoices are drafts unless you ask to approve them. Voiding needs nothing paid or credited against the invoice. Emailing is a separate action, only when you ask, and needs your confirmation.

xeroBill: supplier bills

Gets, creates, updates, approves, voids and deletes bills. The supplier's invoice number goes in the bill's reference, which is how duplicates are found. Before creating a bill, the AI is told to check the supplier's open bills so the same invoice is not entered twice. A paid expense with no bill is a spend money transaction instead.

The same tool handles purchase orders, which post nothing: get, create, update, delete, and convert an approved purchase order into a bill, as a draft unless you ask to approve it. An approved bill is created only when its total matches the purchase order. Deleting a purchase order that is past draft, and converting one, need your confirmation.

xeroQuote: quotes

Creates and updates quotes, marks them sent, accepted or declined, and converts an accepted quote into a sales invoice, as a draft unless you ask to approve it. Xero's API cannot email a quote, so send it from Xero.

xeroRepeatingInvoice: repeating templates

Lists, creates and deletes repeating invoice and bill templates. Each scheduled invoice can be created as a draft or approved. Xero's API cannot edit, pause or run a template early, so change those in Xero.

xeroCreditNote: credit notes

Creates customer and supplier credit notes, as drafts by default, and allocates an approved credit note to an open invoice or bill of the same contact. To correct a posted document that has payments, a credit note is usually better than a void.

xeroPayment: payments

Records money received for a sales invoice, money paid for a bill, or a cash refund of a credit note, overpayment or prepayment, through a chosen bank account on the date the money moved. Part payments are fine. It allocates an overpayment or prepayment to an approved invoice or bill of the same contact, and reads batch payments with each payment's document (read only). Deleting a payment reverses it and reopens the document; it is refused while the payment is reconciled to a bank statement line.

xeroBankTransaction: spend and receive money

Records money in or out with no invoice or bill behind it: card purchases, bank fees, interest, cash sales and owner contributions. These post straight away. If the money settles an invoice or bill, the AI is told to record a payment instead, so the books do not count it twice.

xeroBankTransfer: transfers

Moves money between two of the organisation's own accounts, for example to a tax savings account. Transfers post straight away and need your confirmation. A transfer can be deleted later with your confirmation, but not once either side is reconciled, so check for an existing transfer first.

xeroBanking: the bank view

Reads every bank and credit card account with its opening and closing balance and its unreconciled items, one account's unreconciled items, and the reconciliation status for a period. It is read-only and sees the ledger side only: what is recorded in Xero, not Xero's bank feed or statement lines.

xeroManualJournal: journals

Creates, posts and voids manual journals for accruals, prepayments, depreciation, reclassifications and corrections. Debits must equal credits. Journals are drafts by default and post only when you ask. The AI is told to use a journal as the last resort: anything with a contact or a bank line belongs on an invoice, bill, payment or bank transaction.

xeroTrackingCategory: tracking

Lists, creates, renames and archives tracking categories and their options, such as locations or divisions. Xero allows two active categories with up to 100 active options each. Renaming changes every transaction that uses the option, so the AI confirms first.

Searches one transaction type at a time: invoices, bills, credit notes, payments, bank transactions, transfers, manual journals, quotes, purchase orders, overpayments, prepayments or batch payments. Filters include dates, contact, bank account, status, exact amount, outstanding only, number or reference, and modified since. Rows carry their lines with account and tax codes, which is what makes GST checks possible.

xeroReports: financial reports

Runs profit and loss (with comparison periods and a tracking split), balance sheet, trial balance, aged receivables and payables for one contact, bank summary, executive summary and budget against actual. Ask for cash basis and it runs on payments only. The general ledger report is not available yet: it needs a Xero permission that Xero must approve for our app first.

History and notes

Invoices, bills, purchase orders, credit notes, payments, bank transactions, manual journals, quotes and contacts keep a history in Xero. The AI can read it and add a note, for example why a tax code was changed. Xero keeps notes for good: they cannot be edited or removed.

Workflow tools

The same address also gives the AI DeepLedger's workflow tools: Tasks (the shared to-do list between your team and the AI), each company's AI Brain and skills, Month-end close checklists with sign-off, reconciliation with the proof kept, documents, and saved report packs. These work the same for Xero and QuickBooks Online clients.

How does a person stay in charge?

Some of this is enforced by DeepLedger whatever the AI does, and some is guidance the AI follows.

Enforced by DeepLedger:

  • Drafts by default. Invoices, bills, credit notes and manual journals are saved as drafts unless the request asks to approve or post them. Drafts do not affect reports.
  • Lock dates hold. A write dated on or before the organisation's lock date is refused.
  • Unsafe changes are refused. Voiding a document with payments or credits applied is refused, with what to undo first.
  • Safer retries. Each write carries a one-time key, so a retry after Xero asks DeepLedger to slow down cannot create a second invoice.
  • Bank numbers masked. BSB and account numbers come back with the last four digits only.
  • Read-only members can ask anything but cannot change the books.
  • Audit history records each tool call per company: who, when, which AI app, the tool, the record ids and the result. It keeps no amounts or names from your books.

Guidance the AI follows: read before writing, check the contact and possible duplicates, and when unsure, open a Task with its reasoning instead of guessing. AI models usually follow these instructions, but they are not a lock, so give read-only access where people only need answers.

Payments, spend and receive money, and transfers post straight away. Ask for them only when you mean it.

Working across many Australian clients

  • One sign-in, every organisation. Ask "List my companies" and "Switch to Coastal Joinery".
  • Per-person access. Owners and admins choose who sees each company and whether they can write.
  • Rules stay with each client in its AI Brain: GST basis, BAS period, coding rules and who signs off.
  • One review queue. The portal's Companies page shows open Tasks and close status across every client.
  • Xero and QuickBooks Online together. Clients on either ledger sit behind the same address.

What DeepLedger does not do

  • Lodge a BAS or tax return, or read Xero's Activity Statement or GST Calculation Worksheet. You or your registered agent review and lodge in Xero or with the ATO.
  • Payroll. Pay runs, Single Touch Payroll, PAYG withholding from pay runs and super stay in Xero Payroll. DeepLedger does not ask for payroll access.
  • Fixed asset register or projects. The AI can draft a depreciation journal from your schedule, but it does not read or update Xero's fixed asset register or projects.
  • Bank feeds. Xero companies use Xero's own bank feeds, and Xero's API does not share statement lines, so you finish matching in Xero's Reconcile screen.
  • The general ledger report, until Xero approves the permission for our app.
  • Things Xero's API cannot do: email a quote, or edit or pause a repeating invoice.

Other limits worth knowing:

  • Xero's connection and rate limits. Xero sets how many organisations an app can connect, based on the app's plan with Xero, and allows 60 API calls a minute per organisation. DeepLedger also limits each company to 60 tool calls a minute.
  • Your AI app's plan. ChatGPT, for example, keeps write tools for Business, Enterprise and Edu workspaces. See each app's guide.
  • Hosting. DeepLedger's database, sign-in and file storage are hosted in the United States; see Security. Your AI provider also sees what you ask, so check your firm's policy before using client data.

What does it cost in Australia?

DeepLedger MCP is US$20 per Xero connection per month, or US$220 per connection per year, with unlimited users. A connection is one app connected to one company. Prices are in US dollars, plus applicable tax. The trial runs for 14 days and needs no credit card. Your Xero subscription and your AI app plan are paid separately. Details are on the pricing page.

Troubleshooting

What you seeWhat to do
The AI names the wrong organisationAsk it to list your companies and switch by name, then confirm before any write.
"No active company"Ask the AI to list your companies, then switch to one.
A bill came out with GST added on topThe amounts were read as exclusive. Ask the AI to update the draft with amounts including GST.
"Tax rate not found" or an unexpected tax codeAsk the AI to list the active tax rates and use the exact code.
"On or before the lock date"The period is locked in Xero. Date the correction in an open period, or change the lock date in Xero if that is your decision.
Aged receivables asks for a contactXero runs the aged reports one contact at a time. Ask for all open sales invoices instead.
"Reconnect Xero"Xero's sign-in has lapsed or was revoked. Open the company's Connections tab and choose Reconnect Xero.
"Missing permission" for one reportReconnect Xero once from the Connections tab. If it names the general ledger, see the limits above.
"Rate limited"Wait a minute and retry, or narrow the request to a date range or contact.
A new invoice is missing from reportsIt is a draft. Approve it in Xero, or ask the AI to approve it.

Frequently asked questions

Does DeepLedger's Xero MCP work with Australian Xero organisations?

Yes. DeepLedger connects to Xero through Xero's own API and sign-in, and Australian organisations connect the same way as any other. The AI reads your organisation's own GST tax rates, base currency, GST basis and tax period from Xero, and works in Australian dollars.

Can the AI lodge my BAS or GST return?

No. DeepLedger does not lodge anything with the ATO and does not read Xero's Activity Statement. The AI can pull the period's figures, list transactions by GST tax code and flag lines worth checking. You or your registered tax or BAS agent review the Activity Statement in Xero and lodge it.

Does it handle payroll, Single Touch Payroll or super?

No. DeepLedger does not ask Xero for payroll access, so pay runs, Single Touch Payroll, PAYG withholding from pay runs and superannuation stay in Xero Payroll. The AI works with the accounting side: invoices, bills, payments, bank transactions, journals and reports.

Which GST tax codes can the AI use?

The tax rates set up in your Xero organisation. Xero's Australian tax types are GST on Income, GST on Expenses, GST on Capital, GST Free Income, GST Free Expenses, GST Free Capital, GST Free Exports, Input Taxed, BAS Excluded, GST on Imports and GST on Capital Imports, plus any custom rates you added. DeepLedger tells the AI to read the tax codes from Xero rather than guess them.

Can a BAS agent or firm use one sign-in for every client?

Yes. One DeepLedger sign-in reaches every company you can access, and you switch between clients by asking. Owners and admins choose who sees each company and whether they can write, so a junior bookkeeper can be read-only on one client and read and write on another.

Where is DeepLedger hosted?

DeepLedger's database, sign-in and file storage are hosted in the United States, with Supabase and Render, as listed on the Security page. Your books stay in Xero; DeepLedger reads and writes them through Xero's API when you ask. Check your firm's privacy obligations before using client data in any AI app.

How much does DeepLedger cost in Australia?

DeepLedger MCP is US$20 per Xero connection per month, or US$220 per connection per year, with unlimited users. Prices are in US dollars, plus applicable tax. There is a 14-day free trial with no credit card, and your Xero subscription and AI app plan are paid separately.

Does DeepLedger include a bank feed for Xero?

No. Australian Xero organisations keep using Xero's own bank feeds. The AI reads the bank transactions recorded in Xero and whether they are reconciled, and can prepare a reconciliation from your statement. It cannot see Xero's bank feed or statement lines, so you finish matching in Xero's Reconcile screen.

Sources

Checked on November 11, 2026. Vendor and government pages change, so check them before you rely on a detail.

Start with one organisation

Create a DeepLedger account, connect one Australian Xero organisation, add https://mcp.deepledger.ai/mcp to the AI app you already use, and ask for last quarter's profit and loss. Compare it with Xero, then try one draft bill with GST.

Ready to get started?

Connect QuickBooks and try your first task with an AI agent.

Create an Account

With your permission, Google Analytics measures visits to our public website and blog. Essential cookies work either way. Change your choice in Cookie settings. Privacy policy