💸 MCP Expense Tracker

Python FastMCP Remote MCP Server

Track your expenses locally or remotely with blazing-fast MCP tools!

🚀 Live Remote MCP Server

🌐 Try it now: https://smart-expense-tracker.fastmcp.app/mcp

🖼️ Preview

✨ Features

📦 Local & Remote MCP Server
📝 Add, list, update, and delete expenses
📊 Summarize expenses by date and category
🗂️ Rich category & subcategory support (see below)
🔒 SQLite database for fast, secure storage
⚡ Powered by FastMCP & FastAPI

⚡ Quick Start (Local)

# 1. Clone this repo $ git clone <your-repo-url> $ cd mcp-servers # 2. Install dependencies $ pip install -r requirements.txt # 3. Run the local MCP server $ python main.py

☁️ Remote MCP Server Usage

You can use the remote MCP server instantly:

Endpoint: https://smart-expense-tracker.fastmcp.app/mcp
Compatible with any MCP client or tool that supports remote endpoints.

🛠️ API Tools Overview

Tool Name	Description
`add_expense`	Add a new expense entry
`list_expenses`	List all expense entries
`list_expenses_in_range`	List expenses within a date range
`delete_expense`	Delete an expense by ID
`get_expense`	Get details of a specific expense
`update_expense`	Update an existing expense
`summarize`	Summarize expenses by date/category
`categories`	Get all available categories (JSON)

🗂️ Categories & Subcategories

Your expenses are organized into rich categories and subcategories, including:

Food: groceries, restaurants, coffee, snacks, drinks, fast food, ...
Transportation: public transit, taxi, fuel, parking, ...
Utilities: electricity, water, internet, ...
Entertainment: movies, concerts, streaming, ...
Health: doctor, gym, medications, ...
Shopping: clothing, electronics, gifts, ...
Travel: flights, hotels, vacation, ...
Education: tuition, books, courses, ...
Personal Care: haircuts, spa, skincare, ...
Miscellaneous, Investments, Housing and more!

See categories.json for the full list.

🏗️ Tech Stack

Python 3.13+
FastMCP
FastAPI
Uvicorn
SQLite

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

📄 License

MIT License. See LICENSE file for details.

Made with ❤️ using FastMCP & Python

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables users to track personal expenses through natural language interactions with comprehensive category support and financial summaries. Provides both local and remote MCP server options with SQLite storage for fast expense management operations.

MCP Expense Tracker