# Expense Budget Tracker

> Expense Budget Tracker is an open-source MCP server for finance and payments. Track expenses, budgets and multi-currency balances from an agent with OAuth. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, self-hosted
- **Website:** https://expense-budget-tracker.com
- **Repository:** https://github.com/kirill-markin/expense-budget-tracker/tree/HEAD/apps/sql-api
- **MCP Registry name:** com.expense-budget-tracker/expense-budget-tracker
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Instead of fixed endpoints, the server exposes SQL over a deliberately flat schema. An agent first lists workspaces, inspects allowed relations and columns with get_schema, reads a guide for the SQL dialect or query recipes, then runs one restricted SELECT or one approved INSERT, UPDATE or DELETE.

Access is split by OAuth scope: expenses:read enables the four read tools and a client must also request expenses:write for sql_execute. Authentication uses authorization code with PKCE and dynamic client registration. A separate Agent API uses an ApiKey and an email one-time-code onboarding flow, so a CLI agent can ingest screenshots, CSVs or PDF bank statements.

The tracker itself is open source: multi-currency accounts with ECB, CBR and NBS exchange rates, a monthly budget grid, dashboards and per-user workspace isolation through Postgres row-level security. You can self-host with Docker Compose or use the managed cloud.

## Features

- **Restricted SQL access:** One SELECT or one approved write statement per call.
- **Scoped OAuth:** Read scope enables queries; write scope is required to change data.
- **Multi-currency:** Accounts in any currency with automatic exchange rates.
- **Budget planning:** Monthly grid comparing planned and actual spend.
- **Agent API:** ApiKey access with email one-time-code onboarding.
- **Workspace isolation:** Row-level security gives each user a separate workspace.

## Good for

- Import a PDF bank statement through an agent
- Ask how spending compares with the monthly budget
- Record transfers between accounts in different currencies
- Self-host personal finance data

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http expense-budget-tracker https://mcp.expense-budget-tracker.com/mcp
```

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

```sh
https://mcp.expense-budget-tracker.com/mcp
```

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

```json
{
  "mcpServers": {
    "expense-budget-tracker": {
      "url": "https://mcp.expense-budget-tracker.com/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "expense-budget-tracker": {
      "serverUrl": "https://mcp.expense-budget-tracker.com/mcp"
    }
  }
}
```

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

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

## Tools

- `list_workspaces`: Lists workspaces available to the signed-in user.
- `get_schema`: Shows allowed relations, columns, constraints and limits.
- `get_guide`: Fetches the SQL dialect, writing-data or query-recipes protocol.
- `sql_query`: Runs one restricted SELECT or WITH...SELECT.
- `sql_execute`: Runs one approved INSERT, UPDATE or DELETE.

## FAQ

### Can the agent change my data?

Only if the client requests and you grant expenses:write.

### Can I self-host it?

Yes, with Docker Compose and Postgres; full source is on GitHub.

### Is there feature gating?

The pricing page says all features are in every plan.

### Which exchange rates are used?

ECB, CBR and NBS.

### Is Expense Budget Tracker free?

Yes. Expense Budget Tracker is open source, so you can use and self-host it for free.

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

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

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

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

## 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.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker 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.

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