Skip to main content
Glama
Finance Tracking MCP

Finance Tracking MCP

Finance Tracking MCP

A small MCP server for tracking personal expenses, built with FastMCP and SQLAlchemy on top of SQLite.

Tools

Tool

Description

add_expense

Add a new expense (title, amount, category, optional date and note). Defaults to today's date.

edit_expense

Update an existing expense by ID — only the fields you pass are changed.

delete_expense

Delete an expense by ID. Returns the deleted record.

expense_summary

Totals and a per-category breakdown, optionally filtered by category and/or month (YYYY-MM).

Related MCP server: Expense Tracker MCP Server

Resources

URI

Description

expense://categories

The category list from categories.json, served as JSON.

Requirements

  • Python 3.12+

  • uv

Running

uv run main.py

The server creates expenses.db next to main.py on first run. That file is gitignored, so your data stays local.

Using it with Claude

Add the server to your MCP client config, for example:

{
  "mcpServers": {
    "finance-tracking": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/finance-tracking-mcp", "main.py"]
    }
  }
}

Project layout

main.py           # MCP server: tools, resource, and SQLAlchemy models
categories.json   # Category list exposed via the expense://categories resource
pyproject.toml    # Project metadata and dependencies

Available Tools

3 tools
add_expenseB

Add a new expense entry to the database.

Inputs: title (required), amount (required), category (required), date, +1 more. Returns: object

edit_expenseB

Edit an existing expense by ID. Only pass the fields you want to change.

Inputs: expense_id (required), date, note, title, +2 more. Returns: object

expense_summaryA

Get a spending summary, optionally filtered by category and/or month.

Inputs: month, category. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool serves a clearly distinct purpose: summarizing expenses, adding new ones, and editing existing ones. There is no overlap or ambiguity in their functions.

    Naming Consistency4/5

    Two tools follow a verb_noun pattern (add_expense, edit_expense), while expense_summary deviates slightly as a noun-first name. This minor inconsistency does not hinder readability.

    Tool Count5/5

    With only 3 tools, the server is well-scoped for a focused expense tracking purpose. Each tool earns its place with no redundancy or excess.

    Completeness3/5

    The server covers add, edit, and summary, but lacks a delete operation and a way to retrieve individual expense details. This represents a notable gap in lifecycle coverage.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables users to track and manage daily expenses through SQLite storage, supporting operations like adding, updating, deleting expenses, calculating totals by category, and filtering expenses by date range or category.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables tracking and managing personal expenses through a local SQLite database. Supports adding, editing, deleting, listing, and summarizing expenses by category, as well as managing credit accounts.
      6
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language management of personal expenses, including adding, listing, and summarizing expenses with local SQLite storage.
      -
    • F
      license
      B
      quality
      D
      maintenance
      Tracks and manages personal expenses with tools to add, view, filter by category, and summarize spending over date ranges using SQLite storage.
      4
      -