Provides tools for analyzing workout history exported from Hevy, allowing users to track exercise progress, volume trends, and personal records while incorporating custom training conventions and muscle group mappings.
Provides read-only SQL access to query workout datasets and retrieve database schemas, enabling complex data analysis of stored workout history.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hevy Workout Analytics MCP ServerAnalyze my bench press progress while accounting for my form resets."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hevy Workout Analytics MCP Server
An MCP (Model Context Protocol) server that provides Claude with SQL access to your Hevy workout data, plus rich context about your personal training conventions.
Features
📊 SQL Access: Query your workout history with full SQL capabilities
🏋️ Exercise Taxonomy: Customizable muscle group mappings for exercises
📝 Personal Conventions: Track your specific rules (form resets, RPE usage, etc.)
🔒 Read-Only: Safe SQL execution with no write permissions
🎯 Smart Analysis: Let Claude write complex queries to answer nuanced questions
Architecture
Installation
Clone and install:
Import your Hevy data:
Configure Claude Desktop (
~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):
Usage
Example Questions for Claude
"Which triceps exercises progressed best in the last 6 months?"
"Which exercises have plateaued?"
"What are my PRs for compound lifts?"
"Show volume trends for chest exercises"
"Account for form resets when analyzing bench press progress"
Available Tools
execute_sql(query) - Run read-only SQL queries
get_schema() - Get database schema with column descriptions
get_exercise_taxonomy() - View/understand exercise-to-muscle mappings
get_tracking_conventions() - Read your personal tracking rules
Configuration
Exercise Taxonomy (taxonomy.yaml)
Map exercises to muscle groups and specify compound movement credit:
Tracking Conventions (conventions.yaml)
Document your personal rules for analysis:
Database Schema
The importer creates a workout_sets table with all Hevy CSV columns:
title- Workout namestart_time,end_time- Workout timestampsexercise_title- Exercise nameset_index- Set numberweight_lbs,reps,distance_miles,duration_seconds- Performance metricsrpe- Rate of Perceived Exertionexercise_notes- Per-exercise notesAnd more...
Development
Run tests:
Format code:
License
MIT