🏃 Garmin Nutrition Coach

Turn Claude into your personal, data-driven health coach — self-hosted, private, ~$0/month.

Your own MCP server connects Claude to your Garmin wearable data (34 tools) and your Notion workspace. A nightly job writes your real measured calorie burn into your food log — so your deficit numbers come from your body, not from formulas — and a built-in calibration loop checks them against your actual scale weight every two weeks.

Chat with Claude like a coach who has actually seen your data: "How did I sleep?" · "Coach me today" · "Why did my run feel bad?" · 📸 [photo of lunch]

✨ Features

Related MCP server: Garmin Health MCP Server

🚀 Install (no coding needed)

Open Claude and paste:

Read https://github.com/bank3005-jpg/Garmin-nutrition-coach/blob/stable/SETUP.md and set this up for me

Claude interviews you (goals, body stats), creates your Notion databases, and walks you through the cloud steps. 45–60 minutes, one time.

Prerequisites: a Garmin watch · Notion account (free) · Google account with billing enabled (stays within free tier) · Claude plan with custom connectors · Windows or macOS computer for one step.

🏗️ Architecture

Claude (any device, incl. phone)
   └── your Cloud Run server  ← this repo, deployed to YOUR Google account
         ├── Garmin Connect   ← your token, created on your own computer
         ├── your Notion      ← food / training / body logs
         └── playbook.md      ← coaching rules, served live from GitHub
   Cloud Scheduler → nightly close-day job + keep-warm pings

Privacy by design: everything runs in your accounts. No third party — including this repo's author — ever sees your data. The server is protected by a long random secret; Garmin credentials never pass through chat.

🧰 What's inside (34 MCP tools)

Wellness sleep (+HRV, RHR, body battery) · stress · SpO2 · respiration · heart rate · daily summary Training activities & date-range search · splits · HR zones · FIT streams · aerobic decoupling · training readiness/status · VO2max · race predictions · endurance & hill scores · lactate threshold · personal records · fitness age Body weight history · body composition · write body-comp entries (log InBody/DEXA scans into Garmin) System one-call coach snapshot · direct Notion food-log read/write · live playbook loader

🔄 Updating

• Coaching rules — update automatically (served live from this repo)

• Server code — git pull + one deploy command, or enable a Cloud Build trigger on stable for fully automatic deploys

• Want to customize the code? Fork the repo and point your deployment at your fork

❓ FAQ

Is it really free? Yes — Cloud Run free tier covers personal use many times over. The setup guide includes guardrails so you stay in it. Does my data go anywhere? No. Your server, your Garmin token, your Notion. Self-hosted means self-owned. What if Garmin changes their API? The community library this builds on (python-garminconnect) gets patched quickly; update with one git pull + deploy. Garmin China accounts? Not supported (separate system). No watch some days? The nightly job falls back to your formula baseline and tags the day estimated.

🙏 Credits

Built on python-garminconnect by cyberjunky · fitdecode · MCP by Anthropic.

⚠️ Disclaimer

This is a personal tracking and coaching tool, not medical advice or a medical device. Calorie and macro estimates are approximations. Consult a healthcare professional for medical decisions, and stop training and seek care for any concerning symptoms.

📄 License

MIT — use it, fork it, share it.