Expense Tracker MCP Server
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 Server log $35 for groceries today"
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 Server
A Model Context Protocol (MCP) server for tracking personal expenses and wallet balance, built with FastMCP and SQLite. Lets Claude Desktop, Cursor, or any MCP client log expenses, summarize spending, and check your balance through natural conversation.
Features
Log expenses with date, amount, category, subcategory, and note
List expenses within a date range
Summarize spending by category over a date range
Track and update a wallet balance
A predefined category/subcategory taxonomy exposed as an MCP resource
Related MCP server: expense-mcp
Tools
Tool | Description |
| Insert an expense record |
| List expenses in an inclusive date range |
| Sum expenses by category over a date range |
| Read the current wallet balance |
| Set the wallet balance |
All dates use YYYY-MM-DD format and are validated on input.
Resources
expense://categories: JSON taxonomy of categories and subcategories (food, transport, housing, utilities, health, education, and more), read fresh fromcategories.jsonon every request.
Setup
Requires Python 3.11+ and uv.
uv syncClaude Desktop config
{
"mcpServers": {
"expense-tracker": {
"command": "/path/to/expense-tracker-mcp-server/run.sh"
}
}
}Replace /path/to/expense-tracker-mcp-server with the absolute path to this repo.
Storage
Data is stored in a local SQLite database (expenses.db, created automatically on first run, gitignored). Override the location with the EXPENSE_TRACKER_DB_PATH environment variable.
Testing
uv run pytestLicense
MIT
Available Tools
5 toolsadd_expenseC
Add a new expense entry to the database.
Inputs: date (required), amount (required), category (required), note, +1 more. Returns: object
get_balanceA
Get the current wallet balance in Rs.
Inputs: no named parameters. Returns: object
list_expensesA
List expense entries within an inclusive date range.
Inputs: end_date (required), start_date (required). Returns: result
set_balanceB
Set the wallet balance to a specific amount in Rs.
Inputs: amount (required). Returns: object
summarizeB
Summarize expenses by category within an inclusive date range.
Inputs: end_date (required), start_date (required), category. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: adding expenses, listing them, summarizing by category, and managing the wallet balance. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (add_expense, list_expenses, summarize, get_balance, set_balance), making them predictable and easy to understand.
The set of 5 tools is well-scoped for an expense tracker, covering core expense management and balance tracking without unnecessary duplication or bloat.
The tools cover the core workflows (add, list, summarize expenses; get/set balance). Missing update/delete for expenses, but the domain is largely covered for typical use cases.
Related MCP Connectors
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Log, query, and edit expenses, budgets, and accounts in Manilo (formerly Ledgy) from any MCP-compatible AI assistant.
Log, query, and edit expenses, budgets, and accounts in Ledgy from any MCP-compatible AI assistant.
Personal finance by conversation: expenses, receipts, statement import, budgets, net worth.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseAqualityDmaintenancePersonal expense tracker MCP server that enables tracking expenses, income, budgets, and savings goals through natural language.1030 PyPI1MIT
- FlicenseNot gradedqualityDmaintenanceEnables users to track expenses by adding, listing, and summarizing them with category support through natural language.-
- AlicenseNot gradedqualityBmaintenanceEnables personal finance management through natural language: log expenses, snap receipt photos, and import bank statements. Computes budgets, trends, and net worth in any currency, with data persisted and accessible via MCP.2MIT