wheytoo-smart

MCP server that connects your Hevy workouts and MyFitnessPal food logs into one intelligence layer. Calculates your real TDEE from actual data (not a formula guess), tracks your bulk/cut/recomp phase, tells you when your bench is stalling because you're not eating enough, and manages the macro-level decisions that every lifter faces.

Works with Claude Desktop and Cursor. Open source. Free to use with Hevy's CSV export, or live with Hevy Pro.

Quick Start

1. Get your data sources ready

Hevy (workouts) — pick one:

• Free: Export your workout CSV from Hevy app → Profile > Settings > Export & Import Data
• Pro ($4.99/mo): Get your API key at hevy.com/settings?developer

MyFitnessPal (nutrition — optional):

• Export your session cookies from your browser (look for sessionid in MFP cookies)
• Requires Python 3.12+ and pip install myfitnesspal

2. Configure Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

With Hevy Pro (live API):

{
  "mcpServers": {
    "wheytoo-smart": {
      "command": "npx",
      "args": ["-y", "wheytoo-smart"],
      "env": {
        "HEVY_API_KEY": "hvy_your_key_here",
        "MFP_SESSION_COOKIES": "{\"sessionid\": \"your_cookie\"}"
      }
    }
  }
}

With Hevy Free (CSV import):

{
  "mcpServers": {
    "wheytoo-smart": {
      "command": "npx",
      "args": ["-y", "wheytoo-smart"],
      "env": {
        "HEVY_CSV_PATH": "/path/to/hevy-export.csv",
        "MFP_SESSION_COOKIES": "{\"sessionid\": \"your_cookie\"}"
      }
    }
  }
}

MFP is optional — training-only tools (volume, 1RM, balance, plateaus) work without it.

3. First-time setup

Open Claude Desktop and say:

1. "Check my connections" — verifies Hevy and MFP are working
2. "Import my Hevy data" — (CSV mode only) loads your exported workouts
3. "Set my profile: 175lb, male, 25, 5'10, intermediate, PPL, 5 days/week, bulking since Jan 15"
4. "Sync my exercises" — maps your exercises to muscle groups

You're ready.

What You Can Ask

Nutrition:

• "Check my protein this week"
• "Audit my calories — am I eating enough for my bulk?"
• "What should I eat before my workout today?"

Training:

• "Show my training volume per muscle group"
• "What are my estimated maxes?"
• "Is my training balanced? Push vs pull?"
• "Are any of my lifts stalling?"
• "What's my recovery score?"

Phase management:

• "Should I bulk or cut?"
• "What's my real TDEE?"
• "Generate a calorie cycling plan"
• "What should my macros be?"
• "How's my bulk going?"
• "Am I cutting too aggressively?"
• "Is my recomp working?"
• "Is it time to end this phase?"

All 21 Tools

| Tool | What it does | |------|-------------| | set-profile | Store your body metrics, goals, and phase info | | check-connection | Verify Hevy + MFP connectivity | | import-hevy-csv | Import Hevy CSV export (free mode) | | sync-exercises | Map your exercises to muscle groups | | protein-check | Compare daily protein vs target for your goal | | calorie-audit | TDEE from actual training frequency vs real intake | | pre-workout-fuel-check | Check if you've eaten enough before training | | weekly-training-volume | Sets per muscle group with MEV/MRV assessment | | phase-advisor | Recommends bulk/cut/recomp based on 30-day trends | | adaptive-tdee | Real TDEE from intake + weight regression (21+ days) | | calorie-cycling-plan | Training-day vs rest-day calorie/macro targets | | macro-split-advisor | Phase-specific protein/carb/fat recommendations | | bulk-phase-tracker | Weight gain rate, strength trend, productive vs dirty | | cut-phase-tracker | Weight loss rate, strength preservation, protein check | | recomp-progress-check | Weight stability + strength gains + volume capacity | | phase-transition-check | When to end your current phase and what's next | | plateau-detector | Stalled lifts + nutrition cross-reference | | recovery-score | 1-10 readiness from training load + nutrition | | estimate-1rm | e1RM for compound lifts with progression trend | | muscle-balance-check | Push:pull, quad:ham, anterior:posterior ratios | | should-i-bulk-or-cut | Quick direct answer to the eternal question |

Hevy Modes

| | API (Pro) | CSV (Free) | |---|---|---| | Cost | $4.99/mo | Free | | Data | Live, auto-fetched | Manual re-export + re-import | | Setup | HEVY_API_KEY env var | HEVY_CSV_PATH + run import-hevy-csv | | All tools work? | Yes | Yes |

Requirements

• Node.js 18+
• Hevy account (free or Pro)
• MyFitnessPal account + Python 3.12+ (optional, for nutrition tools)
• Claude Desktop or Cursor

Development

git clone https://github.com/your-username/wheytoo-smart.git
cd wheytoo-smart
pnpm install
pnpm run build
pnpm test

Run locally:

HEVY_CSV_PATH=./my-export.csv node dist/index.js

How It Works

The server reads your real workout data from Hevy and real nutrition data from MyFitnessPal. It applies exercise science — Epley formula for e1RM, Mifflin-St Jeor for BMR, linear regression for adaptive TDEE, evidence-based volume guidelines (Schoenfeld, Israetel), and standard phase management thresholds.

Every recommendation is backed by your actual numbers, not generic advice.

License

MIT