💸 MCP Expense Tracker

---

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

<!-- Add screenshots or diagrams here! Example: -->

---

✨ 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