# TILL

> TILL is an open-source MCP server for finance and payments. Open-source Swiss SME ERP with QR-bill and MWST that an AI agent can run locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://tillbooks.ch
- **Repository:** https://github.com/tillbooks/tillbooks
- **MCP Registry name:** io.github.tillbooks/tillbooks
- **Categories:** finance and payments, productivity
- **Listing updated:** 2026-11-14

## About

Swiss small businesses are the target: the books live in a single SQLite file on your own computer or a server you host, and no server of the vendor holds a copy. The README counts 852 MCP tools, one for every function, and a Studio app shows what the agent did.

By default the agent drafts and you approve. It waits for your OK before booking, moving money, granting access or permanently deleting data, and you choose per area whether it may act alone. Every call is recorded. The ledger is append-only: a correction is a reversing entry, and posting is idempotent.

Swiss specifics include QR-bill invoices with structured addresses, MWST at 8.1%, 3.8% and 2.6% with effective and Saldosteuersatz methods, the eCH-0217 return file, the Kontenrahmen KMU chart of accounts, camt.053 bank import and pain.001 payment files. TILL never sends a payment. It is a public beta (1.0.0-beta.5) and the README advises keeping your old system running until figures match.

## Features

- **QR-bill invoicing:** Issues Swiss QR-bill invoices with structured addresses, plus credit notes, recurring invoices and reminder letters.
- **MWST returns:** Draws the MWST statement from the ledger and produces the eCH-0217 file for the ESTV ePortal.
- **Bank and payments:** Imports camt.053 statements, proposes bookings per line and writes pain.001 files you release in your eBanking.
- **Approval dial:** The agent drafts and waits for your OK on booking, payments, access and permanent deletes unless you allow otherwise.
- **Immutable ledger:** Posted entries are append-only; corrections are reversing entries.
- **Full back office:** Covers purchasing, stock with lots and serial numbers, projects, time tracking, CRM and fixed assets.
- **bexio import:** Imports bexio CSV and Excel exports and runs a parallel check against the old system.

## Good for

- Run bookkeeping and MWST for a Swiss company with an agent doing the data entry
- Match bank statement lines to invoices and approve the proposals
- Move books over from bexio with a parallel run
- Issue QR-bill invoices and send payment reminders
- Manage purchase orders, goods receipts and stock

## Install

### Claude Code (Terminal)

```sh
claude mcp add tillbooks -- npx -y tillbooks
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tillbooks": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
```

## FAQ

### Is TILL free?

Yes. It is MIT licensed with no limit on users, companies or bookings, and there is no paid edition of the software.

### Where is my data stored?

In one SQLite file on your own computer or a server you run; the default path is ~/.till/till.db.

### Can the agent send payments?

No. TILL writes pain.001 payment files that you release in your own eBanking.

### What do I need to run it?

Node.js 22 or newer on macOS or Linux, and an MCP client that can start a local stdio server such as Claude Desktop or Cursor.

### Is it production ready?

It is a public beta. The README says to keep your old system running until the figures match.

### How do I add TILL to Claude Code?

Run this command in your terminal: claude mcp add tillbooks -- npx -y tillbooks

### What are the best alternatives to TILL?

The closest alternatives to TILL are Ha MCP, Concord MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and Budget Tracker.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/till
