Expense Mcp
A personal finance tracker that runs entirely through MCP, giving Claude direct access to SQLite or PostgreSQL to log expenses and income, set monthly budgets with automatic alerts at 80% threshold, and track savings goals with progress visualization. It exposes eleven tools covering CRUD operations on transactions, budget management, and goal tracking, plus three prompt templates for monthly reviews and budget suggestions. The confirmation flow for deletions uses Pydantic elicitation to prevent accidental data loss. Supports both stdio for local desktop clients and HTTP for remote setups. Useful if you want conversational expense tracking without switching to a spreadsheet or dedicated app, and you're comfortable with Claude writing directly to your financial database.
- tools
- 10
- transport
- STDIO
- env vars
- 3
- last updated
- Mar 4, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
expense_addSave expense or income
Save expense or income
No parameter schema in public metadata yet.
expense_searchFilter by text, date, category, amount
Filter by text, date, category, amount
No parameter schema in public metadata yet.
expense_summarytoday / week / month / year totals
today / week / month / year totals
No parameter schema in public metadata yet.
expense_deleteDelete with Pydantic confirmation prompt
Delete with Pydantic confirmation prompt
No parameter schema in public metadata yet.
expense_insightsSpending patterns and top categories
Spending patterns and top categories
No parameter schema in public metadata yet.
budget_setSet monthly category budget
Set monthly category budget
No parameter schema in public metadata yet.
budget_listView budgets with usage %
View budgets with usage %
No parameter schema in public metadata yet.
goal_createCreate savings goal
Create savings goal
No parameter schema in public metadata yet.
goal_updateAdd money toward goal
Add money toward goal
No parameter schema in public metadata yet.
goal_listView goals with progress bars
View goals with progress bars
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
DATABASE_URLSQLite or PostgreSQL database URL
CURRENCYCurrency symbol (default: ₹)
DEFAULT_USERUser ID for multi-user setups
Readme
💰 expense-mcp
Personal Expense Tracker as an MCP Server — works with Claude Desktop, Cursor, nanobot, Windsurf, and any MCP-compatible client.
Features
- 📝 Track expenses & income with categories and descriptions
- 📊 Spending summaries — today, week, month, year
- 💳 Budget management — set limits per category, get alerts at 80%/100%
- 🎯 Savings goals — create goals, track progress with visual bars
- 📈 Spending insights — top categories, daily averages, biggest days
- 🗑️ Safe deletion — Pydantic-based elicitation for confirmation
- 🔄 Dual transport — stdio (local) + streamable HTTP (remote)
Install
# with uv (recommended)
uv pip install git+https://github.com/justfsl50/expense-mcp.git
# with pip
pip install git+https://github.com/justfsl50/expense-mcp.git
Details
- Repository
- github.com/justfsl50/expense-mcp
- Package
expense-mcp- Transport
- STDIO
- Registry
- MCP registry, active