A
licenseA
qualityD
maintenancePersonal expense tracker MCP server that enables tracking expenses, income, budgets, and savings goals through natural language.
10
29 PyPI
1
MIT
Personal Expenses MCP Server
by gunnaabhinay
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., "@Personal Expenses MCP Server Log a $50 grocery expense for Alice in March"
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.
Personal Expenses MCP Server
An MCP server for tracking a personal monthly budget — salary, per-month snapshots, and running expenses — exposed as tools an MCP client (e.g. Claude Desktop or Claude Code) can call directly in conversation.
Data is stored in memory only; it resets whenever the server restarts.
Requirements
Python >= 3.12
Related MCP server: expense-tracker-mcp-server
Install
uv syncRun
uv run python main.pyTools
Tool | Description |
| Adds a new person with their initial base salary. |
| Starts a new tracking month for a person, snapshotting their current (or updated) salary. |
| Logs an expense against a person's month and returns the updated total spent / salary left. |
| Returns the full expense breakdown and remaining balance for a person's month. |
Using with an MCP client
Add an entry to the client's MCP server config (e.g. Claude Desktop's claude_desktop_config.json):
{
"mcpServers": {
"main": {
"command": "uv",
"args": ["run", "--frozen", "--directory", "/absolute/path/to/PersonalExpenses_MCPServer", "python", "main.py"]
}
}
}Available Tools
4 toolsadd_personA
Adds a new person to the budget database with their initial base salary.
Inputs: name (required), base_salary (required). Returns: result
get_monthly_statementA
Returns a full breakdown of all logged expenses and the current remaining budget balance.
Inputs: name (required), month (required). Returns: result
initialize_new_monthC
Initiates a new tracking month for a person. Explicitly prompts for whether their salary has updated for this new month.
Inputs: name (required), month (required), has_salary_changed (required), new_salary_amount. Returns: result
log_expenseA
Adds a new expense to the month's total. Deducts it from the salary and instantly computes the remaining balance.
Inputs: name (required), month (required), description (required), amount_in_dollars (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A3.7/5.0
Scored across 4 tools
Disambiguation5/5
Each tool addresses a distinct lifecycle step: person creation, month setup, expense logging, and statement retrieval. There is no overlapping functionality between any pair of tools.
Naming Consistency5/5
All tool names follow a consistent verb_noun pattern (add_person, initialize_new_month, log_expense, get_monthly_statement). The verbs are clear and uniformly formatted in snake_case.
Tool Count5/5
Four tools is a well-scoped size for a personal expense tracker, covering the core workflow without unnecessary bloat. Each tool serves a clear purpose.
Completeness4/5
The core monthly expense cycle is covered: add person, initialize month, log expenses, view statement. Minor gaps include lack of expense edit/delete and inability to view historical statements, but these are workable for a simple expense tracker.
Maintenance
ActivityInactive
ResponsivenessNo recent community issues
Related MCP Connectors
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
MCP server for generating rough-draft project plans from natural-language prompts.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- FlicenseBqualityDmaintenanceMCP server for tracking personal expenses using FastMCP and SQLite, enabling adding, listing, updating, deleting expenses and summarizing by category via natural language tools.51-
- -licenseNot gradedqualityNot gradedmaintenanceA personal accounting MCP server that enables AI assistants to record and query financial transactions through natural language, supporting income/expense tracking, balance inquiry, and monthly summaries.-
- FlicenseNot gradedqualityDmaintenanceA local MCP server for tracking personal expenses using SQLite, enabling users to add, list, and summarize expenses via natural language.-