amazfit-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
amazfit-mcp
MCP server that turns Claude into your personal training analyst — crossing your training spreadsheet (strength) and Amazfit watch (running + recovery via Apple Health). No frontend, no hosting: just data exposed as tools; Claude does the analysis.
16 tools: weeks, sessions and exercise progression from the spreadsheet · runs with pace/HR/TRIMP · resting HR, HRV and sleep · ACWR and daily CTL/ATL/TSB (form) · a transparent 0–100 readiness score · daily notes exported to Obsidian · a self-contained HTML health report.
Setup
python3.12 -m venv .venv && .venv/bin/pip install -e .
claude mcp add amazfit-mcp \
--env PYTHONPATH="$PWD/src" \
--env AMAZFIT_MCP_XLSX="$PWD/data/planilha.xlsx" \
--env AMAZFIT_MCP_RECOVERY_DIR="$HOME/Library/Mobile Documents/com~apple~CloudDocs/HealthAutoExport" \
-- "$PWD/.venv/bin/python" -m amazfit_mcpOptional envs: AMAZFIT_MCP_OBSIDIAN_DIR (vault folder for the daily notes),
AMAZFIT_MCP_HR_MAX / AMAZFIT_MCP_HR_REST (your real HRs, to calibrate TRIMP).
Watch data (one-time, on the iPhone): Zepp app → Profile → Apple Health → enable
HR, resting HR, Sleep, HRV. Then install Health Auto Export, create a daily JSON
automation (those metrics + Workouts) into an iCloud folder — the MCP reads it from
there. Validate by asking Claude for recovery_status.
Already have a CSV dump? If you exported everything from Health Auto Export as CSV instead of the JSON automation, backfill the store with:
python -m amazfit_mcp.hae_csv ~/Downloads/HealthAutoExport_<date>Related MCP server: garmin-claude-mcp
Use
Just ask Claude:
"how was my Saturday of week 1?" · "am I progressing on the squat?" · "how is my form?" · "am I ready to train hard today?" · "export this week's notes to Obsidian"
Development
.venv/bin/pip install -e .[dev]
.venv/bin/python -m pytest # 94 tests
.venv/bin/ruff check . && .venv/bin/mypy # lint + types (same gate as CI)Architecture, spreadsheet layout and design decisions: CONTEXT.md.
There is also an experimental Zepp cloud extractor: python -m amazfit_mcp.zepp_cloud --help.
Contributing
Open source, MIT. Issues and PRs welcome — keep tests green and add one
for what you change. Good first ideas: extractors for other watches that write the
Health Auto Export format into the store (zero reader changes), stress/PAI in the
Zepp extractor, more sports in workouts.py. If this helped you, a ⭐ helps others
find it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Apple Health training load, recovery, HRV and workout detail for Claude, ChatGPT and any MCP client.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
tri-train is a training platform for triathletes that syncs activities from Strava and Garmin and exposes them to Claude through a remote MCP server. Ask Claude how your last block went, why your run pace dropped, or whether you are fresh enough for Sunday's race, and it answers from your real data: activities with laps and grade-adjusted pace, weekly load and the performance management chart (CTL/ATL/TSB), sleep, HRV and resting heart rate, and your race calendar with predictions. Claude can also act: create and adjust planned workouts with structured intervals, push them to your Garmin watch, add races and write notes. Every change is journaled and can be undone. Read and write access are separate OAuth scopes, and the server enforces them on every call. Built and hosted in Switzerland by a triathlete; data stays on our own servers (Swiss revDSG / GDPR).
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent training activities and wellness data, then create, update, or delete structured workouts through intervals.icu so they sync to Garmin Connect and a watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent activities and wellness data, then design, create, update, and delete structured workouts that sync through intervals.icu to Garmin Connect and the user's watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training activities and wellness metrics and to create, update, or delete structured planned workouts through intervals.icu, which syncs them to Garmin Connect and the user's watch. It provides tools for reviewing recovery signals, listing upcoming calendar events, and pushing AI-designed sessions to the watch without exposing Garmin credentials.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent activities and wellness data (sleep, HRV, resting HR) and to create, update, and delete structured planned workouts, which sync through intervals.icu to Garmin Connect and onto the user's watch.MIT