Skip to main content
Glama
Expense Tracker MCP

Expense Tracker MCP

by krabhis

Expense Tracker MCP

An MCP server for recording and analyzing personal expenses. The server uses FastMCP and stores data locally in a SQLite database, so no external database service is required.

Features

  • Add an expense with a date, amount, category, subcategory, and note.

  • List expenses for an inclusive date range.

  • Summarize spending by category for an inclusive date range.

  • Expose the category and subcategory list as the expense://categories MCP resource.

  • Create the SQLite database automatically on first start.

Related MCP server: Expense Tracker MCP Server

Installation

Clone or download the repository and open a terminal in the project directory:

cd path\to\expenseTracker_mcp

Install the project and its dependencies with uv:

uv sync

If uv is not installed, install it pip install uv

Start the MCP server

Run the server over the default MCP stdio transport:

uv run python -m expensetracker_mcp.main

Keep this process running while your MCP client connects to it. The first start creates src/expensetracker_mcp/expenses.db if it does not already exist.

MCP client configuration

For an MCP client that supports a JSON server configuration, use the following entry and replace the path with the absolute path to this repository:

{
	"mcpServers": {
		"expense-tracker": {
			"command": "uv",
			"args": [
				"--directory",
				"C:\\path\\to\\expenseTracker_mcp",
				"run",
				"python",
				"-m",
				"expensetracker_mcp.main"
			]
		}
	}
}

For a client that requires an absolute executable path, use the path to your uv installation instead of uv.

Available MCP tools

add_expense

Adds one expense entry.

list_expenses

Lists all expenses between start_date and end_date, inclusive. Results are ordered by the database record ID.

summarize

Totals expenses by category between start_date and end_date, inclusive. The optional category argument limits the result to one category.

Categories resource

The expense://categories resource returns the contents of src/expensetracker_mcp/categories.json as JSON. It contains the supported top-level categories and their subcategories. The file is read each time the resource is requested, so category changes are available without restarting the server.

Available Tools

3 tools
add_expenseAdd ExpenseC

Add a new expense entry to the database.

Inputs: date (required), amount (required), category (required), note, +1 more.

list_expensesList ExpensesB

List expense entries within an inclusive date range.

Inputs: end_date (required), start_date (required).

summarizeSummarizeA

Summarize expenses by category within an inclusive date range.

Inputs: end_date (required), start_date (required), category.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: adding, listing, and summarizing expenses. There is no overlap or ambiguity when selecting between them.

    Naming Consistency4/5

    Mostly follows a verb_noun pattern (add_expense, list_expenses), but 'summarize' lacks a noun suffix, creating a minor inconsistency. Still predictable and readable.

    Tool Count5/5

    Three tools are well-scoped for a simple expense tracker and each earns its place. No bloat or deficiency.

    Completeness4/5

    Core expense tracking operations are covered (create, read, summarize), but missing update/delete functionality is a notable gap. Agents can work around this for read-heavy use cases.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • 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
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables logging and tracking personal expenses in a local SQLite database with category/subcategory validation, offering tools to add, view, summarize, and delete expenses.
      4
      -