tillbooks/tillbooks

**Trusted Independent Ledger Library.** The agent-first ERP for Swiss SMEs.
TILL is a free, open-source (MIT) ERP for Swiss small businesses: sales, purchasing, payments, stock,
projects, books and MWST. Every function is exposed as an MCP tool, 800 of them, so your AI agent runs
it and the Studio (the app you work in) shows you what it did. It works with Claude Desktop, Cursor
and other MCP clients that can start a local stdio server. TILL runs on your own computer, or on a
server you host yourself. Your books are a single SQLite file on that machine, and no server of ours
holds a copy.
By default, the agent waits for your OK before it books anything, moves your money, grants access
or deletes your data for good: it drafts, and you approve. For each of
those areas you decide whether it may act on its own. Much of what you can change back, such
as drafts and contact details, runs without asking, and every call the agent makes is recorded.
The dial covers agents that connect to TILL. An agent that can drive your browser or run commands on
your computer can act as you: give your agent TILL, not your browser or your shell.
> **Public beta, version 1.0.0-beta.1.** Nomadik GmbH, the company behind TILL, keeps its own books
> in it. If you move your books to TILL, keep your old system running until the figures match, and
> read what the beta does not do yet first.
Why
TILL is MIT licensed and costs nothing. You can run it, change it and keep it, with no limit on
users, companies or bookings, and your books stay on a computer you control. It is built for what
makes Swiss books Swiss:
- **QR-bill** (Swiss QR-Rechnung) with the structured-address standard
- **MWST** at 8.1%, 3.8% and 2.6%, with the effective and the Saldosteuersatz method, and the
MWST-Abrechnung drawn straight from the ledger
- **Kontenrahmen KMU** seeded out of the box
- **ISO 20022** banking: camt.053 statements in, pain.001 payment files out
- de-CH and en
What TILL covers
- Accounting: double-entry ledger, period locks and year close, foreign currencies and revaluation,
accruals, fixed assets, and several companies in one install.
- MWST: the MWST-Abrechnung per period, reconciled to the ledger, and the eCH-0217 file you upload
to the ESTV ePortal.
- Sales: quotes, orders, delivery notes, invoices with the QR-bill, credit notes, recurring invoices,
reminder letters and the open-items list.
- Purchasing: supplier bills with input VAT, purchase orders, goods receipt, expense claims, and
pain.001 payment files that you release in your eBanking. TILL never sends a payment.
- Bank: import the camt.053 statements from your eBanking. The bank inbox proposes a booking for
each line it can place, and you confirm it.
- Contacts and CRM, products and stock (warehouses, lots and serial numbers, stock valuation),
projects and time tracking, documents, reports.
- Moving in: import from bexio's CSV and Excel exports (there is no bexio API connection), a trial
company to try the import on, and a parallel run that checks TILL's figures against your old
system. Fixed assets, stock and payroll history do not come over, and last year's journal lands
in a read-only archive beside the live books.
The ledger is not negotiable
Posted entries are append-only and immutable. A correction is a **reversing entry**, never a
destructive edit, exactly as real accounting works. Posting is idempotent: a double-post does not
double-count. These are asserted in the test suite, not merely promised in a README.