Skip to main content
Glama
Sign In
ExpenseTracker MCP Server

ExpenseTracker MCP Server

by Anshu857754
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

ExpenseTracker MCP Server

An MCP server for tracking personal expenses, built with FastMCP 3.x. Expenses are stored in a local SQLite database and accessed asynchronously via aiosqlite.

Requirements

  • Python >= 3.12

  • uv

  • Node.js (only for the MCP Inspector during development)

Related MCP server: local-expense-tracker

Setup

git clone <repo-url>
cd Test-Remote-Server
uv sync

Running

Start the server over HTTP:

uv run main.py

The server listens on http://0.0.0.0:8000/mcp. To use a different port, edit the mcp.run(...) call at the bottom of main.py.

Development

Run the server with the MCP Inspector UI:

uv run fastmcp dev inspector main.py

If the default Inspector ports (6274/6277) are taken, pick your own:

uv run fastmcp dev inspector main.py --ui-port 6280 --server-port 6281

Note that uv run is required — the Inspector spawns fastmcp as a child process, and without uv run the virtualenv's Scripts/bin directory is not on PATH.

Tools

Tool

Parameters

Description

add_expense

date, amount, category, subcategory="", note=""

Add a new expense entry

list_expenses

start_date, end_date

List entries in an inclusive date range

summarize

start_date, end_date, category=None

Total and count per category

Dates are YYYY-MM-DD strings.

Resources

URI

Description

expense:///categories

Category list as JSON

Categories are read from categories.json next to main.py. If that file is absent, a built-in default list is served instead.

Storage

The SQLite database lives at expenses.db inside the system temp directory; the path is printed at startup. It is created automatically on first run.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • Expense Tracker MCP Server

    ameympatil
    F
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server for tracking personal expenses. This server provides tools to add, list, and summarize expenses, utilizing a local SQLite database for storage.
    3
    -

  • local-expense-tracker

    K37VIN
    F
    license
    Not graded
    quality
    D
    maintenance
    A local MCP server for tracking personal expenses using SQLite, enabling users to add, list, and summarize expenses via natural language.
    -

  • Expense Tracker MCP

    InfoSage05
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for tracking expenses with local SQLite storage. Provides tools to add, list, and summarize expenses by category.
    -

  • Expense Tracker MCP

    ayush-patel-29
    F
    license
    Not graded
    quality
    D
    maintenance
    A simple MCP server for tracking expenses in a local SQLite database, enabling add, read, update, delete, and summarization of expenses with predefined categories.
    -