🏠 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

Related MCP server: mail-cal-drive-mcp

Setup

1. Install dependencies

pip install -r requirements.txt

2. Configure credentials

cp .env.example .env
# Edit .env with your Gmail address and App Password

Gmail 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