DeepLedger
Menu

Troubleshooting

Xero MCP Connected but Not Working? Eight Checks to Fix It

Your AI app is connected to Xero through DeepLedger but something is off: no tools, the wrong organisation, a reconnect prompt, a rate limit or a write that is refused. Eight checks, in the order to try them.

Published by DeepLedger6 min read

If your AI app is connected to Xero through DeepLedger but answers wrongly or not at all, check eight things in order: the connector, the sign-in, the active company, the Xero connection, your access, Xero's rate limits, lock dates and signed-off closes, and whether the record is still a draft. Most problems are one of the first three.

This guide is for anyone who followed a setup guide such as Connect Claude to Xero or Connect ChatGPT to Xero and hit a problem afterwards. For QuickBooks Online, use QuickBooks MCP troubleshooting.

Quick reference

What you seeMost likely causeFix
No DeepLedger or Xero tools in the AI appConnector address or sign-inCheck 1 and 2
"No active company"No company chosen yetCheck 3
Answers about the wrong clientActive company changed in another appCheck 3
"Reconnect Xero" or needs reconnectingXero's sign-in has lapsedCheck 4
A company is missing from the listNot assigned to youCheck 5
A write is refused as read onlyYou are a read-only member thereCheck 5
"Rate limited"Xero's API limit for the organisationCheck 6
A change is refused for a closed periodA Xero lock dateCheck 7
A close step is refused as lockedThe close was signed offCheck 7
A new invoice is not in reportsIt is a draftCheck 8

1. Is the connector address right?

The address is exactly https://mcp.deepledger.ai/mcp, ending in /mcp. If the AI app shows no DeepLedger tools, remove the connector, add it again with the full address, and sign in again.

2. Did the sign-in finish?

The AI app signs in to DeepLedger, not to Xero. Use your DeepLedger account on the sign-in screen and choose Allow. If the window closed early, or your AI app shows the connector as not connected, sign in again from the app's connector settings.

Then ask:

Using DeepLedger, which company am I in? List every company I can access with its ledger.

3. Is the right company active?

Every tool works on one active company, and every result names it. The active company is stored per person, not per app: a switch in Claude also applies to your next request in ChatGPT or Cursor.

  • If the AI says there is no active company, ask it to list your companies and switch to one.
  • Use the exact company name. If a name matches more than one company, or none, DeepLedger refuses the switch; switch by the company id from the list instead.
  • If the active company uses QuickBooks, the AI uses the QuickBooks tools for it. Switch to the Xero company first.
  • If a write is refused because the company changed (another chat may have switched it), confirm the company and ask again.

4. Is Xero still connected?

If the AI reports that Xero needs reconnecting, Xero's sign-in for that organisation has lapsed. An admin opens the company in DeepLedger, goes to its Connections tab and reconnects Xero through Xero's own sign-in. Nothing in the AI app needs to change.

5. Do you have access to that company?

You reach only the companies you are assigned to. If one is missing from the list, ask an owner or admin to assign it to you under Settings → Team.

If the AI can read but every change is refused, you are probably a read-only member for that company. That is by design: an owner or admin decides who can write.

6. Did you hit Xero's rate limit?

Xero limits API calls for each organisation: 60 a minute, 5 at a time and 5,000 a day. DeepLedger sits out short waits on its own. If a longer limit is reached, the request was not processed: wait a minute, narrow the date range, or ask for fewer records per page. Large multi-client requests are best done one organisation at a time.

7. Is the period locked or signed off?

Two kinds of lock can refuse a request:

  • Xero's lock dates. Nothing dated on or before a lock date can change. Ask the AI to read the organisation's profile, which includes its lock dates.
  • A signed-off close in DeepLedger. When a reviewer signs off a month-end close, the close is locked: the AI cannot change its checks or sign-off, and only a person can reopen it, in the portal. This does not lock the books in Xero; to stop changes to a closed month, set a Xero lock date.

8. Is it still a draft?

Through DeepLedger, new invoices, bills, credit notes and manual journals are created as drafts unless you ask for them to be approved. Drafts do not appear in Xero's reports until someone approves them. Payments, Spend Money, Receive Money and transfers post at once.

Actions that cannot be undone, such as voids and emailing a document, need an explicit confirmation step. If the AI asks you to confirm, it is waiting for you, not stuck.

Still stuck?

Ask the AI to report the problem to DeepLedger: the companies tool has a feedback option that sends a message to the team, with no financial data. Or contact support with the time, the AI app you used, the company name and the error text.

Frequently asked questions

Why does my AI app show no Xero tools?

Usually the connector address is wrong or the sign-in did not finish. Remove the connector, add it again with the full address https://mcp.deepledger.ai/mcp, sign in with your DeepLedger account, and check that the active company is a Xero company.

Why is the AI working in the wrong Xero organisation?

The active company is stored per person, not per app, so a switch in one AI app also applies to the next request in another. Ask the AI which company you are in, then switch to the right one by its exact name or by its id.

What does Xero's rate limit mean for an AI agent?

Xero limits API calls for each organisation, to 60 calls a minute, 5 at a time and 5,000 a day. DeepLedger waits out short limits on its own; if a longer one is reached, wait a minute, narrow the date range or ask for fewer records at a time.

Why did the invoice the AI created not show in my Xero reports?

Through DeepLedger, new invoices, bills, credit notes and manual journals are created as drafts unless you ask for them to be approved. Drafts do not affect reports until someone approves them in Xero or asks the AI to approve them.

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