TILL MCP Server

by tillbooksio.github.tillbooks/tillbooksv0.1.0

Local-first Swiss accounting: double-entry journal entries, invoice categorization and follow-up, and Swiss VAT (MWST) returns, stored in local SQLite.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active11d ago

Install TILL MCP server

claude mcp add tillbooks -- npx -y tillbooks mcp

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

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

Add to .vscode/mcp.json in your workspace.

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

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

Configuration

Variable	Required	Secret	Description
TILL_DB_PATH	—	—	Path to your TILL SQLite ledger. Leave unset for the default (~/.till/till.db); TILL bundles no database.
TILL_SUPPORT_DIR	—	—	Where TILL keeps machine-scoped state (diagnostics, backups). Leave unset for the default (~/.till).