M
MCP Expense Tracker
by @DP132
An MCP-powered expense tracking platform that combines personal finance management with collaborative group expense sharing. Features include OAuth authentication, invite-code based groups, role management, settlement calculations, audit logs, PostgreSQL persistence, and a responsive FastAPI + Bootstrap web interface.
Created 5/30/2026
Updated about 5 hours ago
README
Repository documentation and setup instructions
MCP Expense Tracker
A full-stack expense tracking application built on the Model Context Protocol (MCP), featuring personal expense management, collaborative group expense sharing, invite-code based group membership, role-based access control, settlements, and audit logs.
Features
Personal Expense Tracking
- Add, edit, and delete expenses
- Categorize expenses
- Multiple payment methods
- Recurring expenses
- Tags and descriptions
- Dashboard analytics
Group Expense Management
- Create and manage expense groups
- Automatic invite code generation
- Join groups via invite codes
- Join request approval workflow
- Multiple split methods
- Settlement calculations
- Group balance tracking
Access Control
- Owner, Admin, and Member roles
- Multi-admin support
- Role management
- Group privacy controls
Audit & Monitoring
- Group activity audit logs
- Membership change tracking
- Administrative action history
Authentication
- OAuth 2.0 with PKCE
- Secure session handling
- MCP-compatible authentication flow
Tech Stack
Backend
- Python 3.11+
- FastAPI
- SQLAlchemy
- PostgreSQL
- MCP (Model Context Protocol)
Frontend
- Bootstrap 5
- Bootstrap Icons
- HTML/CSS
- JavaScript
Installation
Clone Repository
git clone https://github.com/DP132/mcp_expense_tracker.git
cd mcp_expense_tracker
Create Virtual Environment
python -m venv mcp_env
Activate Environment
Windows:
mcp_env\Scripts\activate
Linux / macOS:
source mcp_env/bin/activate
Install Dependencies
pip install -r requirements.txt
Configure Environment
Run Application
uvicorn backend:app --reload --port 8001
Open:
http://localhost:8001/app
Project Structure
mcp_expense_tracker/
│
├── backend.py
├── frontend.py
├── db.py
├── mcp_server.py
├── requirements.txt
├── README.md
│
├── models/
├── services/
├── static/
└── templates/
Core Functionality
- Expense Tracking
- Group Expense Splitting
- Invite Code System
- Join Approval Workflow
- Role-Based Access Control
- Settlement Management
- Audit Logging
- OAuth Authentication
- MCP Tool Integration
Future Improvements
- Email notifications
- Expense attachments
- Budget planning
- Mobile application
- Advanced analytics
- Export reports
Quick Setup
Installation guide for this server
Install Package (if required)
uvx mcp_expense_tracker
Cursor configuration (mcp.json)
{
"mcpServers": {
"dp132-mcp-expense-tracker": {
"command": "uvx",
"args": [
"mcp_expense_tracker"
]
}
}
}