Skip to content

GetMy Books ​

Version 1.0.0. Check your Xero books from inside Claude. It lists what looks wrong, with the records behind each finding so you can confirm it in Xero; nothing changes until you approve it; each check says what it did not cover. £19.99 per company per month, no VAT charged. Start at getmy.group.

GetMy Books is software for owner-directors of UK limited companies on Xero, used from Claude. It checks the books in Xero, gets a VAT return draft ready for you to check and file, checks the bank in Xero against statement files you download (it never connects to a bank), and warns about HMRC and Companies House deadlines. Every figure is worked out by code, never by the language model. Nothing is written to Xero without a preview you approve, and GetMy Books files nothing: you or your accountant file.

It is a software tool, not an accountancy service: GetMy Books staff do not review or work on your books, and its findings are things to check, not advice (ADR 0036). New customer? Start with Getting started.

There are two ways to connect.

Claude on the web, desktop or phoneClaude Code on your own computer
Good forEveryday use, including writing to XeroDevelopment, and bank statement files (CSV, OFX, QIF) on your disk
Writes to XeroYes: each write shows a preview card, and happens only when you press Approve in itYes, through the deployed connector: each preview gives a link to approve it on mcp.getmy.group, signed in. Saying yes in the chat writes nothing
SetupA few clicksDeveloper setup (below)

A company's owners can write to its Xero. The approval link opens a page on mcp.getmy.group, behind the same sign-in as your account pages, showing only that one preview, with Approve and Decline; opening it writes nothing (SPEC-022).

Planned, not live yet: letting someone who is not an owner, such as your accountant, write to one named company. The Product Owner would name them for that company in GetMy Books' production settings (XERO_WRITE_PRINCIPALS, in Doppler prd), and being named would never give anyone access to a company they cannot already see. It waits for a separate spec for non-owner access (SPEC-022 S2).

Connect in Claude (web, desktop app or phone) ​

Before you start: sign up at mcp.getmy.group/start with your email (a one-time code), accept the terms, and connect your company's Xero there (ADR 0038). You can set up and connect before you subscribe; the checks need a subscription (SPEC-016).

  1. In Claude, open Settings → Connectors → Add custom connector.
  2. Name it GetMy Books and paste this URL:
    https://mcp.getmy.group/mcp
  3. Select Connect. On the sign-in page choose Email and enter the code sent to the address you signed up with. (Get My Books Ltd's own operators sign in with their Microsoft account in the getmy.group tenant, with multi-factor authentication.)
  4. Back in Claude, turn the connector on in a new chat and ask: "Set up my company profile", then "What deadlines are coming up?"

You stay signed in for 8 hours; after that Claude asks you to reconnect.

What you can ask:

  • "What's due for FEAW?" (HMRC and Companies House deadlines)
  • "Help me file FEAW's confirmation statement" (the checklist, who needs a personal code, and the steps to file it yourself on Companies House's service)
  • "Prepare FEAW's VAT return for June to August 2026"
  • "Check the filed VAT return for March to May 2026 against Xero"
  • "What's unreconciled on the Starling account for August?"
  • "Why didn't this bank line match?"
  • "Forward my receipts to Xero": with your own Outlook or Gmail connector turned on, Claude finds receipts in your mailbox, shows you the list, and forwards them to your company's Xero Files inbox only after you say yes. GetMy Books itself never reads your mailbox.
  • "Attach the receipts I forwarded to Xero" or "Which August purchases have no receipt?"
  • "Reconcile my Amex with my receipts": each receipt in the Xero inbox is matched to an Amex payment, and all the attachments go in one card for you to approve. If a receipt was not paid with a company card, archive it yourself in Xero Documents.
  • "Enter the missing Starling lines for August" or "Correct the VAT on those two insurance payments": GetMy Books shows a preview card, and nothing reaches Xero until you press Approve in it. Claude cannot press it for you.
  • "Invoice Wealth Tech Professionals £24.17 plus VAT for the lounge" or "Enter the British Airways bill for £372.20": GetMy Books looks the contact up, works out net, VAT and total by code, and shows a preview card; your Approve creates the draft invoice or bill in Xero, with the receipt from your Xero inbox attached in the same step. A bill a director paid personally is addressed to the director's own contact, says "Paid personally" and is left awaiting payment; how it is settled is still to be decided.

How receipts work now: Xero renamed Files to Documents. Its Smart Document Capture reads each receipt, marks it Match or Review, and attaches it to the bill or spend money itself, so check the Match items in Xero Documents first. The GetMy Books receipt tools are for what Xero has not matched. Documents may also show more files than GetMy Books lists. Attaching a receipt does not reconcile the bank line: that still happens in Xero's bank reconciliation.

For an Amex card, attach the statement CSV in the chat. GetMy Books reads it for that one request and keeps nothing, then shows what it read (lines, dates, charges and payments) so you can compare it with the statement. This checks the card. Entering an Amex card's missing lines, and matching Amex receipts, are not available yet: enter those in Xero.

If it doesn't work ​

What you seeWhat it means
Cloudflare page: "You don't have permission" / access deniedYou chose a sign-in method you can't use: choose Email and use the address you signed up with
"You do not have access to GetMy Books yet, or its terms have changed"Open mcp.getmy.group/start: finish signing up and connecting Xero, or accept the current terms
A tool says the company is not subscribedSubscribe from the start page, or ask Claude "how do I subscribe"
"Failed to fetch user/group information"The Microsoft app registration needs attention: tell the Product Owner
It worked yesterday and now asks you to sign inYour 8-hour session ended: reconnect
Error 1033 or 502The server on the NAS is down: tell the Product Owner

Connect in Claude Code (your own computer) ​

This route runs the server on your machine. It lists the tools that write to Xero (entering missing bank lines, VAT correction journals, draft invoices and bills), but each write needs your Approve in the approval card, which Claude Code cannot show. To write to Xero from Claude Code, connect it to the deployed server instead (https://mcp.getmy.group/mcp): each preview then gives a link to approve it on mcp.getmy.group, signed in (SPEC-022). Or use Claude on the web, desktop or phone (AUDIT C5).

You need:

  • Access to the getmy-books project in Doppler, with the Doppler CLI installed and signed in (doppler login).
  • Node 22 and pnpm through corepack.
  • Claude Code.

Steps:

  1. Clone this repository and install:
    bash
    git clone https://github.com/FEAW-Serv/getmy-books.git
    cd getmy-books
    corepack pnpm install
  2. Open Claude Code in the folder. It finds .mcp.json, which starts getmy-books-mcp with settings from Doppler (getmy-books, dev).
  3. Approve the getmy-books-mcp server when Claude Code asks (or run /mcp).
  4. Ask "What deadlines are coming up?"

Optional setting MCP_REPLY_JSON_TEXT (SPEC-011 S8, for testing token savings): unset or on keeps every reply as it is; off drops the JSON text block that repeats structuredContent, so the reply carries the summary only. Errors are unchanged. To try it in Claude Desktop, add it to the server's env in claude_desktop_config.json, then restart Desktop:

json
{
  "mcpServers": {
    "getmy-books-mcp": {
      "command": "doppler",
      "args": ["run", "-p", "getmy-books", "-c", "dev", "--", "node", "--import", "tsx", "/path/to/getmy-books/src/mcp/stdio.ts"],
      "env": { "MCP_REPLY_JSON_TEXT": "off" }
    }
  }
}

Keep whatever command and args you already use; only env is new.

Optional setting XERO_JOURNALS_SCOPE (SPEC-014, QD-43): unset (the default) leaves the Xero connect as it is, and account_history builds an account's history from invoices, bills, credit notes, bank transactions, payments and manual journals, saying which postings it cannot see. on adds the accounting.journals.read scope to the connect, so after a reconnect account_history reads Xero's journals and the history is complete. Set it only once the GetMy Books Xero app's tier includes that scope (Xero's Advanced tier and a security assessment, ADR 0024): asking for a scope the app does not have can make the connect fail.

Note: the local server and the web route currently share the same database on the NAS, so what you do locally shows up on the web too (issue #73).

What GetMy Books is not ​

GetMy Books checks and proposes; you decide. It is not an accountant, and it does not give advice.

  • It does not stand behind a figure for you. Every figure comes from code and shows the records behind it, so you can confirm it in Xero before you rely on it. You stay responsible for your books, your filings and every change you approve.
  • It does not judge the grey areas. Tax law is full of intent, reliefs and negotiation. Where a question needs judgement, such as whether a project qualifies for R&D relief, GetMy Books says so and you ask your accountant.
  • It does not know your business. A cash-flow figure is arithmetic; what to do about it depends on people and context only you have.
  • It does not file. Nothing goes to HMRC or Companies House from GetMy Books. You or your accountant file.

How it is built around this:

  • Code-built summaries that Claude shows as they are, never recalculated.
  • A preview and your Approve, in a card Claude cannot press, before anything is written to Xero.
  • Each check names what it did not cover (an account it could not read, lines it could not match), so a clean result never hides a gap.

Selling GetMy Books: terms, liability and AML ​

GetMy Books is sold as a self-service software licence at £19.99 per company per month (ADR 0037), with self-service sign-up (ADR 0038). The boundary that keeps Get My Books Ltd a software vendor rather than an accountancy service provider under the Money Laundering Regulations is in ADR 0036: no human service, the owner does everything, no filing.

The legal documents in docs/legal/ (terms of service, privacy notice, data processing agreement, subprocessors, acceptable use and the FEAW Services Ltd hosting agreement) are in force from 12 October 2026. ADR 0036 section 4 records what was settled before the first paying customer and what is tracked after it.

For developers ​

bash
corepack pnpm install
corepack pnpm test        # also: lint, typecheck, build
corepack pnpm dev         # web app on :3000

Proprietary: see LICENSE.

Adding an operator ​

Customers sign themselves up (above). An operator of Get My Books Ltd, who signs in with Microsoft, needs three things, changed together (ADR 0020): a place on the Cloudflare Access allowlist, a guest account in the getmy.group Microsoft tenant, and an access grant in the database (src/platform/migrations/0005-access-grants.sql, through a new migration).