Expense Tracker
About
Automated expense management with a Supabase backend and hierarchical category support.
Details
- Author
- keyurgit45
- Categories
- Productivity, Finance, Database, Other, Automation
Jump to
Setup
Install Expense Tracker in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/keyurgit45/expense-tracker-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Automated expense management with a Supabase backend and hierarchical category support.
AI-powered expense tracking system with natural language interface, intelligent categorization, and real-time sync.
The system uses a two-server architecture:
- MCP Server: Core expense tracking tools exposed via Model Context Protocol
- Gemini AI Server: FastAPI server providing chat interface with authentication
- 🤖 Natural language expense management via Gemini AI
- 🧠 Intelligent categorization using embeddings and similarity search
- 🔐 JWT authentication with Supabase
- 📊 Hierarchical categories for organization
- 🏷️ Predefined tag system
- 📈 Real-time data sync
- 🔄 Learning system that improves over time
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt
cp .env.example .env # Add your credentials: # - SUPABASE_URL # - SUPABASE_KEY # - GOOGLE_API_KEY (for Gemini)
Execute the SQL scripts in your Supabase SQL Editor:
# Core tables scripts/create_tables.sql # Embeddings support scripts/create_embeddings_schema.sql
uvicorn app.servers.gemini.main:app --reload --port 8000
# Populate categories python scripts/populate_hierarchical_categories.py # Populate predefined tags python scripts/populate_predefined_tags.py
- POST /chat- Send natural language commands
- POST /auth/refresh- Refresh JWT token
- Create expenses from natural language
- Auto-categorize transactions
- Get spending summaries
- Analyze subscriptions
- View recent transactions
referhttps://github.com/keyurgit45/expense-tracker-client
# Run all tests with mocks ENVIRONMENT=test pytest tests/ -v # Run specific components ENVIRONMENT=test pytest tests/test_mcp_tools.py -v ENVIRONMENT=test pytest tests/test_categorization.py -v
backend/ ├── app/ │ ├── core/ # Business logic │ ├── servers/ │ │ ├── gemini/ # AI chat server │ │ └── mcp/ # MCP tool server │ └── shared/ # Shared configs ├── scripts/ # Utilities └── tests/ # Test suite
- Generates embeddings for transactions using Sentence Transformers
- Finds similar past transactions using pgvector
- Uses weighted voting to predict categories
- Falls back to rule-based matching
- Learns from user confirmations
Perform queries and entity operations in your Fibery workspace.
Execute Beancount queries and submit transactions to a ledger.
Unofficial MCP server for fintable.io — manage financial categories, rules, and transactions through AI assistants instead of clicking through multi-step wizards.
An AI-powered chat server for tracking job interview processes, integrated with Supabase.
Provides MCP access to OculusMind.AI agents who search the web, analyze stocks and products, automate and schedule workflows and utilize other MCP server tools.
An MCP server for interacting with the Pleasanter low-code/no-code business application platform.
MCP-native open-source Notion alternative: read and write pages, customizable databases, and kanban/calendar boards over a remote MCP server (OAuth 2.1 + PKCE, scoped tokens, audit log).
Official Supabase MCP server for managing Supabase projects, databases, auth, storage, edge functions, and SQL workflows from AI agents.
VS Code extension and MCP server for Airtable, formula editor, schema tools, and 30+ automation utilities for bases, views, and fields.
Log, query, and edit expenses, budgets, and accounts from Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant — the only expense tracker with a native MCP server.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
