Expense Tracker MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Expense Tracker MCP Add a $45 lunch expense to Dining"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Expense Tracker MCP
An MCP server for recording and analyzing personal expenses. The server uses FastMCP and stores data locally in a SQLite database, so no external database service is required.
Features
Add an expense with a date, amount, category, subcategory, and note.
List expenses for an inclusive date range.
Summarize spending by category for an inclusive date range.
Expose the category and subcategory list as the
expense://categoriesMCP resource.Create the SQLite database automatically on first start.
Related MCP server: Expense Tracker MCP Server
Installation
Clone or download the repository and open a terminal in the project directory:
cd path\to\expenseTracker_mcpInstall the project and its dependencies with uv:
uv syncIf uv is not installed, install it pip install uv
Start the MCP server
Run the server over the default MCP stdio transport:
uv run python -m expensetracker_mcp.mainKeep this process running while your MCP client connects to it. The first start creates src/expensetracker_mcp/expenses.db if it does not already exist.
MCP client configuration
For an MCP client that supports a JSON server configuration, use the following entry and replace the path with the absolute path to this repository:
{
"mcpServers": {
"expense-tracker": {
"command": "uv",
"args": [
"--directory",
"C:\\path\\to\\expenseTracker_mcp",
"run",
"python",
"-m",
"expensetracker_mcp.main"
]
}
}
}For a client that requires an absolute executable path, use the path to your uv installation instead of uv.
Available MCP tools
add_expense
Adds one expense entry.
list_expenses
Lists all expenses between start_date and end_date, inclusive. Results are ordered by the database record ID.
summarize
Totals expenses by category between start_date and end_date, inclusive. The optional category argument limits the result to one category.
Categories resource
The expense://categories resource returns the contents of src/expensetracker_mcp/categories.json as JSON. It contains the supported top-level categories and their subcategories. The file is read each time the resource is requested, so category changes are available without restarting the server.
Available Tools
3 toolsadd_expenseAdd ExpenseC
Add a new expense entry to the database.
Inputs: date (required), amount (required), category (required), note, +1 more.
list_expensesList ExpensesB
List expense entries within an inclusive date range.
Inputs: end_date (required), start_date (required).
summarizeSummarizeA
Summarize expenses by category within an inclusive date range.
Inputs: end_date (required), start_date (required), category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: adding, listing, and summarizing expenses. There is no overlap or ambiguity when selecting between them.
Mostly follows a verb_noun pattern (add_expense, list_expenses), but 'summarize' lacks a noun suffix, creating a minor inconsistency. Still predictable and readable.
Three tools are well-scoped for a simple expense tracker and each earns its place. No bloat or deficiency.
Core expense tracking operations are covered (create, read, summarize), but missing update/delete functionality is a notable gap. Agents can work around this for read-heavy use cases.
Maintenance
Related MCP Connectors
Track expenses from your AI chat: log, categorize, monthly CSV reports. All data is local.
Personal finance tracker — log transactions, view summaries, and browse a dashboard
Import bank CSV exports, categorise transactions, total them by category or month, match expenses.
Personal finance: accounts, transactions, categories, budgets, goals, debts and spending stats.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables tracking and managing personal expenses through a local SQLite database. Supports adding, editing, deleting, listing, and summarizing expenses by category, as well as managing credit accounts.6-
- FlicenseNot gradedqualityDmaintenanceEnables natural language management of personal expenses, including adding, listing, and summarizing expenses with local SQLite storage.-
- FlicenseBqualityDmaintenanceTracks and manages personal expenses with tools to add, view, filter by category, and summarize spending over date ranges using SQLite storage.4-
- FlicenseAqualityDmaintenanceEnables logging and tracking personal expenses in a local SQLite database with category/subcategory validation, offering tools to add, view, summarize, and delete expenses.4-