Skip to content
MCP server

TILL

Open-source Swiss SME ERP with QR-bill and MWST that an AI agent can run locally

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, Linux, CLI
Runs
Locally
Version
1.0.0-beta.5
Listing updated
3 days ago

About TILL

TILL is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add tillbooks -- npx -y tillbooks

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • TILL_DB_PATHPath to your TILL SQLite ledger. Leave unset for the default (~/.till/till.db); TILL bundles no database.
  • TILL_SUPPORT_DIRWhere TILL keeps machine-scoped state (diagnostics, backups). Leave unset for the default (~/.till).

What it does

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

Pricing

Open source

MIT licensed and free to self-host; Nomadik charges for setup help; hosted plan not priced yet

Prices change. Check tillbooks.ch before you buy.

TILL 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 to TILL

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity