# Budget Tracker

> Budget Tracker is a freemium MCP server for finance and payments. Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** self-hosted, macOS, Windows, Linux
- **Website:** https://mcp.zovo.one/s/expense-tracker
- **Repository:** https://github.com/theluckystrike/mcp-servers/tree/HEAD/servers/expense-tracker
- **GitHub stars:** 2
- **License:** MIT
- **MCP Registry name:** io.github.theluckystrike/budget-tracker
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

Say something like "12.30 euros at Adobe, software, billable to Acme" and the server files it: amounts are stored as integer minor units in their own currency, a vat_rate splits the gross receipt into net and VAT, and merchant rules fill in the category. Set a default VAT rate and currency once with the settings tool and later expenses need no repeats.

Receipts are attached by path and sha256 so a later audit can show the file has not changed, and business trips are priced from a built-in mileage table. Expenses flagged billable can be prepared as invoice line items with a markup. Once an expense is marked rebilled, changing its amount, currency or VAT rate is refused unless you pass unlink_rebill, because the invoice charged something else.

The ledger is local. You can run the MCPB archive in Claude Desktop, build from source with Node.js 22 or newer, or use a hosted URL that carries a free token; the bare URL without a token answers tool calls with 401. A Pro license key, verified offline, unlocks Pro mode.

## Features

- **VAT splitting:** Splits gross amounts into net and VAT using a default or per-expense rate.
- **Merchant category rules:** Categorises new expenses automatically from merchant-to-category rules.
- **Receipt integrity:** Attaches receipts by path and sha256 so tampering shows.
- **Mileage pricing:** Prices business trips from a built-in mileage table.
- **Rebill tracking:** Marks billable expenses as rebilled with an invoice number and guards changes afterwards.
- **CSV export:** Exports the ledger to CSV.

## Good for

- Log a receipt from chat with VAT split
- Track mileage for client trips
- Prepare billable costs for an invoice with markup
- Export expenses to CSV for an accountant
- Auto-categorise recurring merchants

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http budget-tracker https://mcp.zovo.one/mcp/budget-tracker
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.zovo.one/mcp/budget-tracker
```

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

```json
{
  "mcpServers": {
    "budget-tracker": {
      "url": "https://mcp.zovo.one/mcp/budget-tracker"
    }
  }
}
```

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

```json
{
  "servers": {
    "budget-tracker": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/budget-tracker"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "budget-tracker": {
      "serverUrl": "https://mcp.zovo.one/mcp/budget-tracker"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "budget-tracker": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/budget-tracker"
    }
  }
}
```

## Tools

- `expense_add`: Record one expense and return its id, its net/VAT split and its billable flag. The response states every default that was applied, so the caller can see what was assumed rather than having to guess.
- `expense_list`: List expenses in a date range with each one's net/VAT split, category, merchant, project and billable flag, plus a total per currency. Free reads the last 30 days and says when your range predates it.
- `expense_update`: Change one expense by id; only the fields you pass move. amount is in MAJOR units. A rebilled expense refuses an amount, currency or vat_rate edit unless unlink_rebill drops the invoice link.
- `expense_delete`: Delete one expense by id and report what went. The receipt FILE stays on disk. Deleting a rebilled expense loses the record of what an invoice charged, so correct it with expense_update instead.
- `receipt_attach`: Not available on the hosted endpoint: it has no filesystem, so there is no receipt file to read or hash. Attach receipts on a local install instead - download expense-tracker.mcpb from https://github.com/theluckystrike/mcp-servers/releases/latest and open it in Claude Desktop - or record the receipt reference in the expense note.
- `category_rules`: Replace the merchant-to-category rules, or call with no rules to list them. Returns the stored rule list. The rules are applied by expense_add whenever a call gives no category of its own.
- `expense_settings`: Read or set the defaults expense_add uses when a call does not name them: default_vat_rate and default_currency. Returns the stored defaults. Call with no arguments to read them without changing anything.
- `expense_summary`: Totals for a date range grouped by category, project, month or merchant, per currency with gross, net and VAT, never mixed. Receipts only; bank transactions are totalled by bank-statement's statement_summary.
- `mileage_add`: Record a business trip as an expense, priced as distance x rate. Give exactly one of km or miles. Returns the saved id with the rate used, where that rate came from and the money, in the rate's own currency.
- `expense_export`: Export the expenses in a date range as csv, xlsx or json and return a download link that is valid for one hour. Nothing partial is ever written: if a limit is hit no file is produced at all.
- `expense_to_invoice`: Preview the unbilled billable expenses of one project as invoice_create line items (description, quantity, unit_price, tax_rate), grouped per currency. Read-only: nothing is marked rebilled here.
- `expense_mark_rebilled`: Mark expenses as rebilled once the invoice that carries them actually exists. Pass the expense_ids of one currency group from expense_to_invoice, or that project, date range and currency. Returns what was marked.
- `license_status`: Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
- `license_activate`: Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

## FAQ

### Where is my expense data kept?

The registry entry says all data is local, held in a ledger on your machine.

### Does it need an account?

No. The free tier needs no account; an optional Pro license key (MCP_LICENSE_KEY) is verified offline.

### Why does the hosted URL return 401?

The tokenless URL lists tools but rejects calls. Use the link from the connect page that includes a free token, or send a bearer token.

### Is Budget Tracker free?

Budget Tracker has a free plan, with paid plans for more usage or features.

### How do I add Budget Tracker to Claude Code?

Run this command in your terminal: claude mcp add --transport http budget-tracker https://mcp.zovo.one/mcp/budget-tracker

### What are the best alternatives to Budget Tracker?

The closest alternatives to Budget Tracker are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Quantivex Research, Provyan and TribuJus.

## Alternatives

- [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.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [Herramientas de Ecuador · ADVISE.ia](https://ai-powered.com/mcp/herramientas-de-ecuador-advise-ia): Herramientas de Ecuador · ADVISE.ia is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/budget-tracker-2
