Skip to main content
Glama
NeelContractor

Expense Tracker MCP Server

Expense Tracker MCP Server

A simple Expense Tracker MCP server built with FastMCP and SQLite, deployed on FastMCP Cloud.

This project demonstrates how to build, deploy, and connect an MCP server using FastMCP Cloud and Claude Desktop.

Features

Tools

  • add_expense — Add a new expense.

  • list_expenses — View expenses within a date range.

  • summarize — Generate expense summaries by category.

Resources

  • expense:///categories — Returns available expense categories and subcategories.

Related MCP server: Expense Tracker MCP

Tech Stack

  • Python 3.14+

  • FastMCP 3.4.0

  • SQLite

  • aiosqlite

  • FastMCP Cloud

Local Development

Run the server locally:

uv run python main.py

Open MCP Inspector:

uv run fastmcp dev inspector main.py

Deployment

This project is deployed to FastMCP Cloud.

Remote MCP Endpoint (example url):

https://splendid-gold-dingo.fastmcp.app/mcp

Claude Desktop Integration

Create a local proxy server:

from fastmcp import FastMCP

mcp = FastMCP.as_proxy(
    "https://splendid-gold-dingo.fastmcp.app/mcp", # example url, get your url from fastmcp cloud
    name="Neel Server Proxy"
)

if __name__ == "__main__":
    mcp.run()

Install the proxy into Claude Desktop:

uv run fastmcp install claude-desktop proxy.py

Restart Claude Desktop after installation.

Example Prompts

Add an expense:

Add an expense for a cab ride to Delhi last Sunday. The fare was ₹600.

List expenses:

Show all expenses between 2026-06-01 and 2026-06-30.

Summarize expenses:

Summarize my expenses for June 2026.

Categories

The server supports categories such as:

  • Food

  • Transport

  • Housing

  • Utilities

  • Health

  • Education

  • Entertainment

  • Shopping

  • Travel

  • Business

  • Investments

  • Personal Care

  • Taxes

  • Miscellaneous

Learning Goal

This project was created to learn:

  • FastMCP fundamentals

  • MCP tools and resources

  • SQLite integration

  • Async MCP tools with aiosqlite

  • FastMCP Cloud deployment

  • Claude Desktop integration via MCP

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables users to track and manage personal expenses through natural language, including adding entries, filtering by date/category, viewing statistics, and exporting data in JSON or CSV format.
    3
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables tracking of personal expenses with tools to add, list, update, delete, and summarize expenses by category.
    -
  • 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
    C
    quality
    D
    maintenance
    Enables logging, querying, and summarizing personal expenses via natural language, with tools for adding, listing, and aggregating spending by category.
    3
    -