Repository avatar
AI Tools
v1.0.0
active

books

co.lumman/books

Xero, Zoho Books and FreeAgent MCP for AI apps: one answer across all your companies.

Documentation

Multi Books

Xero, Zoho Books and FreeAgent MCP for AI apps: one answer across all your companies.

Multi Books is a remote MCP server run by Lumman Ltd. It connects the books of several companies - your Xero organisations, Zoho Books organisations and FreeAgent companies, all at once - behind one connector, so an AI client can answer one question across every company you run, with no switching between them, and do the bookkeeping in each. This repository holds what clients install: the manifests for Claude Code, Cursor, Gemini CLI and Antigravity, and three skills. The server itself is not in it.

Before you start

You need a Lumman account with at least one company added - in the window your AI client opens when it first connects, or at https://lumman.co/mcp/account/multi-books. Sign in there with Google, Microsoft, a passkey or an emailed code. Each company is added once, with its program's own sign-in - Xero's or Zoho's, where one sign-in adds several organisations, or FreeAgent's. Any number of companies. Each company's read-only switch is on the same page.

Add it to your client

Claude

In Claude: Plugins, Add, Add custom connector. Name it Multi Books, paste https://books.lumman.co/mcp, then approve on the Lumman page that opens. On Team or Enterprise, send this address to an Owner, who adds it as a custom connector in Organization settings, Connectors; then press Connect on it in Claude.

Claude Code

/plugin marketplace add lumman-lab/multi-books
/plugin install multi-books@multi-books

The plugin adds the connector at https://books.lumman.co/mcp and the three skills below. The first time a skill reaches the connector, Claude Code asks you to sign in; if it does not, run /mcp and choose the multi-books server.

Cursor

Add the connector to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "multi-books": { "url": "https://books.lumman.co/mcp" }
  }
}

VS Code

Run MCP: Add Server, choose HTTP, paste https://books.lumman.co/mcp and name it multi-books. Or add it to your user mcp.json:

{
  "servers": {
    "multi-books": { "type": "http", "url": "https://books.lumman.co/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/lumman-lab/multi-books

The extension adds the connector at https://books.lumman.co/mcp and the three skills below. Its first call opens Lumman's sign-in in your browser; /mcp auth multi-books opens it again.

Antigravity

agy plugin install https://github.com/lumman-lab/multi-books

The plugin adds the connector at https://books.lumman.co/mcp and the three skills below, for the Antigravity CLI, app and IDE alike. To sign in, run /mcp in the CLI, open multi-books_multi-books and choose Authenticate, or in the app or IDE press Authenticate next to it under Agent settings, Customizations; approve on the Lumman page that opens, then paste the code Antigravity's page shows back into Antigravity.

ChatGPT

Works fully on ChatGPT Business, Enterprise and Edu.

  1. Open chatgpt.com/plugins, press +, then Add custom MCP server.
  2. Name it Multi Books, paste https://books.lumman.co/mcp, choose OAuth, tick the box and press Create as a plugin.
  3. Install it. On the Lumman page, sign in, add a company if none is connected, and approve.
  4. In a chat, type @ and choose Multi Books.

Any other client

Add a remote MCP server at https://books.lumman.co/mcp: Streamable HTTP, OAuth 2.1 with dynamic client registration. No key or client id is needed.

Signing in

The connector answers a client's first call with where to sign in. The client registers itself with Lumman's authorisation server and opens a Lumman page that names it: sign in, add a company if none is connected, and approve. Every client you approve is listed under Connected AI clients at https://lumman.co/mcp/account/multi-books, where its access can be taken back.

Skills

Claude Code, Cursor, Gemini CLI and Antigravity load three skills with the connector, and pick one by themselves when a request matches it. In Claude Code each is also a command, such as /multi-books:month-end.

  • cash - every bank balance across your companies, totalled in each currency, and on request a forecast 30, 60 and 90 days ahead with its risks. Changes nothing.
  • month-end - a month-end check of each company: bank lines still to explain, overdue invoices and bills, last month's profit and loss and VAT. Changes nothing.
  • who-owes - who owes each company money, or whom each company owes, by how late, in each currency apart. Changes nothing.

Examples:

  • "Who owes money to each of my companies, and how late is each invoice?"
  • "Compare last month's profit and loss across all my companies."
  • "Explain this week's bank transactions in my FreeAgent or Zoho Books company - show me before you change anything."

Ready requests

The connector offers these requests ready-made; a client shows them as prompts or commands.

  • month_end_check - Month-end check. Unexplained bank lines, overdue invoices and bills, last month's profit and loss and VAT returns, company by company.
  • who_owes_me - Who owes me. What each customer owes across all your companies, by how late it is.
  • cash_across_companies - Cash across my companies. Every bank balance across all your companies, totalled in each currency.
  • cash_forecast - Cash forecast. Cash 30, 60 and 90 days ahead across all your companies, from what is owed each way and what recurs, with its risks.

Tools

ToolName
companies_listList companies
bank_accounts_listList bank accounts
bank_transactions_listList bank transactions
contacts_listList contacts
invoices_listList invoices
invoices_getRead an invoice
estimates_listList estimates
estimates_getRead an estimate on Zoho Books
credit_notes_listList credit notes
credit_notes_getRead a credit note on Zoho Books
bills_listList bills
bills_getRead a bill
attachments_getRead an attachment
accounts_listList categories
reports_profit_and_lossRead the profit and loss
reports_balance_sheetRead the balance sheet
reports_trial_balanceRead the trial balance
reports_aged_receivablesRead who owes the company
reports_aged_payablesRead whom the company owes
reports_totals_by_contactRead totals by customer or supplier
reports_cash_flowRead the cash flow statement on Zoho Books
reports_general_ledgerRead the general ledger on Zoho Books
reports_sales_by_itemRead sales by item or product on Zoho Books
tax_returns_listList tax returns
projects_listList projects
time_entries_listList time entries
expenses_listList expenses
journals_listList journals
journals_getRead a journal on Zoho Books
recurring_invoices_listList recurring invoices
recurring_bills_listList recurring bills
purchase_orders_listList purchase orders
purchase_orders_getRead a purchase order on Zoho Books
sales_orders_listList sales orders on Zoho Books
sales_orders_getRead a sales order on Zoho Books
payments_listList payments
tracking_categories_listList tracking categories
items_listList items
tax_rates_listList tax rates
users_listList users on Zoho Books
contacts_createCreate a contact
contacts_updateChange a contact
contacts_deleteDelete a contact on Zoho Books
invoices_createCreate an invoice
invoices_updateChange an invoice
invoices_sendSend an invoice
invoices_voidVoid an invoice
invoices_deleteDelete an invoice
estimates_createCreate an estimate
estimates_updateChange an estimate
estimates_sendSend an estimate
estimates_deleteDelete an estimate on Zoho Books
credit_notes_createCreate a credit note
credit_notes_updateChange a credit note
sales_orders_createCreate a sales order on Zoho Books
sales_orders_updateChange a sales order on Zoho Books
sales_orders_deleteDelete a sales order on Zoho Books
projects_createCreate a project
projects_updateChange a project
time_entries_createRecord time
time_entries_updateChange a time entry
time_entries_deleteDelete a time entry
bills_createCreate a bill
bills_updateChange a bill
bills_deleteDelete a bill
purchase_orders_createCreate a purchase order on Zoho Books
purchase_orders_updateChange a purchase order on Zoho Books
purchase_orders_deleteDelete a purchase order on Zoho Books
attachments_createAttach a file on Zoho Books
expenses_createRecord an expense
expenses_updateChange an expense
expenses_deleteDelete an expense
bank_transactions_codeExplain a bank transaction
bank_transactions_uncodeUndo an explanation
bank_statements_importImport a bank statement on Zoho Books
bank_statements_deleteUndo a statement import on Zoho Books
bank_reconciliations_createReconcile a bank account on Zoho Books
bank_reconciliations_deleteUndo a reconciliation on Zoho Books
payments_recordRecord a payment
payments_updateChange a customer payment on Zoho Books
payments_deleteDelete a customer payment on Zoho Books
journals_createCreate a journal
journals_updateChange a journal
items_createCreate an item
items_updateChange an item
items_deleteDelete an item on Zoho Books
tax_rates_createCreate a tax rate on Zoho Books
tax_rates_updateChange a tax rate on Zoho Books
tax_rates_deleteDelete a tax rate on Zoho Books
accounts_createCreate an account on Zoho Books
accounts_updateChange an account on Zoho Books

Where your books go

Every client sends its calls to https://books.lumman.co/mcp, run by Lumman. Signing in runs through the authorisation server that address names. Lumman keeps no copy of your books: they are read from Xero, Zoho Books or FreeAgent each time a client asks. The words of every invoice, bill, bank line and other record are screened for prompt attacks before they reach your AI client, as are the words of everything a client writes before they reach your program, and the books are passed on only to the client you approved. What the connector passes on, and to whom - the screening service among them - is in the privacy policy: https://lumman.co/privacy.

Switch any one company to read only at https://lumman.co/mcp/account/multi-books and every change there is refused before its program is asked. Multi Books makes no payment, charges no card and files no tax return: it records payments in the books.

Limits

  • One call reads at most four companies; a question across more takes several calls.
  • In Xero, bank entries are recorded but cannot be reconciled, as Xero's API does not allow it; in FreeAgent and Zoho Books, the bank feed's lines are categorised. Tax returns are read in FreeAgent, for their deadlines and amounts due, and in Xero for organisations in Australia and New Zealand, with the 1099 figures in the US; Zoho Books gives its VAT summary.
  • A write whose answer was lost is settled by reading the books back, never by sending it again.
  • A record whose words screen as a prompt attack is withheld rather than passed on, and a call whose screening cannot finish is closed. A file's own bytes - an attachment or a receipt - are not screened.

Security

Report a vulnerability privately through GitHub, as SECURITY.md describes.

Support

Write to the address under Contact Us in Lumman's privacy policy: https://lumman.co/privacy.

Licence

The files in this repository are under the MIT licence in LICENSE. The Multi Books service they connect to is provided under Lumman's terms: https://lumman.co/terms.

Zoho and Zoho Books are trademarks of Zoho Corporation Private Limited and/or its affiliates. Other program names are trade marks of their owners.