MCP Expense Tracker

# 💸 MCP Expense Tracker [](https://www.python.org/) [](https://github.com/robusta-dev/fastmcp) [](https://smart-expense-tracker.fastmcp.app/mcp) --- > **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](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](https://github.com/robusta-dev/fastmcp) & FastAPI --- ## ⚡ Quick Start (Local) ```bash # 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