NumbersGame for Square
NumbersGame connects a client's Square account (point of sale, invoices and subscriptions) to their books in QuickBooks Online or Xero, and lets you work it from Claude. Accounting firms use it to:
- book each period's Square sales as one summary journal per location: card and cash takings, sales by revenue bucket, service charges, sales tax, tips, gift cards and refunds;
- book every payout to the bank, with its fees, Square Capital repayments and reserves, through the bank feed when there is one;
- tie out Square Clearing and cash clearing against Square's payouts before you close;
- run the client's Square from Claude: AR aging of Square invoices, customers, invoices and subscriptions.
How the books see Square
Square is the subledger. Individual orders, payments and customers stay in Square; they are never copied one by one into QuickBooks or Xero. The books get period totals through accounts of their own:
- Square Clearing: card takings on their way to the bank. A payout moves them from Square Clearing to the bank, less fees.
- Cash clearing: cash taken at the till, until it is banked.
- Gift card liability and Tips payable: gift cards sold but not yet redeemed, and tips owed to staff. Tips are never revenue.
Sales are split into revenue buckets: a few income lines such as drinks, food and merchandise, set per Square category, with an item rule only for an exception. Each location (shop) can book to its own class and sales tax account.
A Square invoice is booked only when it is paid, through the period summary. An unpaid one stays in Square.
Prerequisites
In Square
- The client's Square account, and the person who holds it, to approve NumbersGame once on Square's own screen.
In NumbersGame
- A firm account. Every firm has the Square connector; if NumbersGame has switched it off for yours, ask support@numbersgame.xyz to switch it back on.
- The client's QuickBooks Online or Xero company connected, and you signed in as an owner or admin of the firm.
In Claude
- The NumbersGame – Square connector, included in the NumbersGame package (install it from Set up → Package in NumbersGame). Connect it in the plugin's Connectors tab and sign in with your NumbersGame account the first time. Without the package, add it from Claude's connectors directory: NumbersGame – Square, then Connect. Where the directory is not available, add it as a custom connector with the address
https://square.numbersgame.xyz/mcp. - The main NumbersGame connector (
https://mcp.numbersgame.xyz/mcp) as well, so Claude can look up the chart of accounts while you map Square.
Set it up
- Connect Square. Open the client's company in NumbersGame and go to its Square accounts section. Click Connect Square. Square opens; the account holder approves NumbersGame, and you return to the same section, which shows the account or explains why not.
- Assess the account. Ask Claude "Assess the Square account for Acme." It looks at the locations, the catalog categories with 30 days of sales, the payout banks and the ledger accounts still to map, and lists the next steps. It writes nothing.
- Set up the accounts. Agree with Claude, or on the company page under Set up accounts, which ledger account each Square line books to: Square Clearing, cash clearing, sales, refunds, sales tax payable, tips payable, gift card liability, Square fees, chargebacks, reserve, adjustments and, if the client has one, the Square Capital loan and its fee. Claude uses accounts already in the chart, and creates only what is missing after you agree. Choose the cadence (monthly or daily), the time zone and the cutoff: the first day NumbersGame books.
- Agree the revenue buckets. Under Revenue buckets on the company page, or with Claude, map each Square category (plus custom amounts and named service charges) to an income account and, if you like, a class.
- Refresh the connector in Claude if it says it has no Square tools: refresh the connector's tool list and start a new conversation.
Every month
- Propose the summary. "Build the Square sales journal for Acme for September." Claude drafts one journal per location for an ended period and lists anything it holds back (sales no rule covers, other currencies, orders that don't balance). Nothing posts until you approve.
- Book it. On your OK Claude posts exactly the journal you were shown. If Square changed since (a late refund), nothing posts and you see the new version. The first period booked needs a word on what happened before the cutoff, because Square's own sync or a person may already have posted those sales.
- Book the payouts. "Book Acme's paid Square payouts." Each payout moves from Square Clearing to the bank (on the bank-feed line when there is one), with its fees, Capital repayments and reserves as one journal. A payout waits, booking nothing, when its bank-feed line hasn't arrived or something it needs isn't set up.
- Tie out. "Tie out Square for Acme." Every payout since the cutoff (does it add up, is it booked), payouts still unbooked, and the Square Clearing and cash clearing balances. Differences are shown, never posted away.
Everyday Square tasks from Claude
Ask Claude. Anything that changes Square is shown to you first and happens only when you confirm.
| Task | Ask Claude |
|---|---|
| Who owes what on Square invoices | "Square AR aging for Acme." |
| Find an invoice or a customer | "Which Square invoices for Acme are unpaid?" |
| Look up what was sold | "What did Acme's Main Street shop sell on Saturday?" |
| Create a customer or an invoice | "Create a Square invoice for Jane Doe for the catering order." Created as a draft: you review it and publish it in Square |
| Cancel an unpaid invoice | "Cancel Square invoice 0042." Square tells the customer |
| Cancel a subscription | "Cancel Jane Doe's subscription." Square ends it at the end of the current period. Starting a subscription or changing its plan is done in Square |
What to ask Claude
- "Assess the Square account for Acme and tell me what to set up."
- "Build the Square sales journal for Acme for September and show it to me."
- "Book Acme's paid Square payouts for September."
- "Tie out Square for Acme and explain any difference."
- "Which Square invoices are overdue, and who owes what?"
Permissions and data
NumbersGame asks Square to read the business profile, payments, orders, payouts, catalog items, bank accounts, gift cards, disputes, cash drawers, customers, invoices and subscriptions. To act when you ask, it can also write customers, invoices (create or cancel) and subscriptions (cancel only; Square does not let our app create a subscription or change its plan). Every change is previewed and needs your confirmation. A firm viewer, and any company set read-only in NumbersGame, can never change anything.
NumbersGame stores the connection (the Square account, its business name, the permissions granted and the encrypted access tokens), the setup and revenue buckets you chose, and a record of each period and payout it booked, so nothing is booked twice. Square customers, orders and payments are read when you ask and passed to Claude. Details are in the privacy policy.
Disconnecting
- Disconnect in the company's Square accounts section: NumbersGame's access is revoked at Square and the stored tokens are wiped. What was booked stays in the books.
- Remove a disconnected account to take it off the company's list. The record of what was booked is kept, so connecting the same account again never books a period twice.
- Removing NumbersGame's access inside Square also disconnects it.
- To end access at Square itself, disconnect before deleting the company in NumbersGame.
Troubleshooting
- There is no Square accounts section on the company's page. NumbersGame has switched the connector off for your firm; ask support@numbersgame.xyz to switch it back on.
- "Only an owner or admin can connect Square." Ask an owner or admin of your firm to connect it.
- "This Square account is already connected to …" One Square account books into one company, so totals are never counted twice. Disconnect it on the company named, then connect it here.
- "The Square connection timed out or was started in another tab." Start again from Connect Square on the company's page.
- "Access was not granted in Square, so nothing was connected." The approval was declined in Square. Start again and approve.
- "Your firm's connections are all in use." A Square account uses part of a connection. Billing shows what is using each one.
- Claude says it has no Square tools. Refresh the Square connector's tool list in Claude, then start a new conversation.
- Sales are listed as unmapped. No revenue bucket covers them: add a rule for their category (or for custom amounts) and propose the summary again.
- A payout waits. Its bank-feed line hasn't arrived yet, or an entry type, the payout bank or a Square Capital loan isn't set up. Claude says which.
FAQ
Does NumbersGame copy Square orders into QuickBooks or Xero? No. The books get one summary journal per location per period; the detail stays in Square.
Can Claude change things in Square? Yes, when you ask: it creates customers and draft invoices, and cancels invoices and subscriptions. Each is shown first and happens only when you confirm. Publishing an invoice, starting a subscription or changing its plan, and anything that charges a card are done in Square. Viewers and read-only companies cannot.
Can I use it next to Square's own QuickBooks or Xero sync? Not for the same sales. If Square's sync already posts them, the connector would book them a second time. Use one or the other, and set the cutoff to the first day the connector books.
Can one Square account book into two companies? No, one at a time.
Which currencies? The company's home currency. Orders in other currencies are listed as held, not booked.
Support: support@numbersgame.xyz · Security: security policy
