🏠 Home Tracker MCP
A personal MCP server for tracking household expenses and shared notes, with pre-built email templates to keep you and your wife in sync.
---
Features
| Tool | What it does | |-----------------------|---------------------------------------------------| | log_expense | Add an expense with category, amount, date | | get_summary | Weekly or monthly breakdown by category | | add_note | Save a shared note with optional tag | | get_notes | Retrieve notes, filter by author or tag | | delete_note | Remove a note by ID | | send_weekly_digest | Email a formatted spending report | | send_alert | Email a one-off alert (big purchase, budget warn) |
---
Setup
1. Install dependencies
pip install -r requirements.txt2. Configure credentials
cp .env.example .env
# Edit .env with your Gmail address and App PasswordGmail App Password: Go to https://myaccount.google.com/apppasswords and generate a password for "Mail". Use that instead of your real password.
3. Run locally to test
python server.py---
Add to Claude Desktop
Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add this block inside "mcpServers":
{
"mcpServers": {
"home-tracker": {
"command": "python",
"args": ["/absolute/path/to/home-tracker-mcp/server.py"],
"env": {
"PYTHONPATH": "/absolute/path/to/home-tracker-mcp"
}
}
}
}Restart Claude Desktop. The tools will appear automatically.
---
Example usage with Claude
- "Log a $67 grocery run at HEB today"
- "Give me a summary of our spending this month"
- "Add a note reminding us to cancel the gym membership"
- "Send the weekly digest to both of us"
- "Alert my wife that I just spent $800 on car repair"
---
Categories to get started
groceries · utilities · dining · rent · transport · health · subscriptions · entertainment · clothing · misc
