Hevy MCP Server

A Model Context Protocol (MCP) server for integrating with the Hevy workout tracking app API. This server provides tools and resources for managing workouts, routines, and exercise data through the MCP protocol.

Features

- Workout Management: Create, read, and analyze workouts
- Routine Management: Manage workout templates and routines
- Exercise Templates: Access and search exercise databases
- Progress Tracking: Analyze workout trends and progression
- Data Resources: Access workout and fitness data as MCP resources

Installation

$3

``bash
npm install -g hevy-mcp-server
`

$3

`bash
npm install hevy-mcp-server
`

Quick Start

1. Set your Hevy API key
`bash
export HEVY_API_KEY=your_hevy_api_key_here
`

2. Run the server
`bash
hevy-mcp-server
`

MCP Configuration

$3

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

`json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": ["hevy-mcp-server"],
"env": {
"HEVY_API_KEY": "your_hevy_api_key_here"
}
}
}
}
`

$3

For other MCP clients, use:

`bash
HEVY_API_KEY=your_key hevy-mcp-server
`

MCP Tools Available

$3


- get_workouts - Get paginated list of workouts
- get_workout - Get specific workout details
- get_all_workouts - Get all workouts automatically
- create_workout - Create a new workout
- get_workout_count - Get total workout count
- analyze_workout_trends - Analyze workout patterns and progress

$3

- get_routines - Get paginated list of routines
- get_routine - Get specific routine details
- get_all_routines - Get all routines automatically
- create_routine - Create a new routine
- get_routine_folders - Get routine organization folders
- create_routine_folder - Create new routine folder

$3

- get_exercise_templates - Get all available exercises
- search_exercise_templates - Search exercises by name/muscle group
- get_exercise_history - Get exercise performance history

MCP Resources Available

- hevy://workouts - Complete workout data with statistics
- hevy://routines - All workout routines and templates
- hevy://exercise-templates - Exercise database with muscle groups
- hevy://routine-folders - Routine organization folders
- hevy://account-summary - High-level account statistics
- hevy://recent-workouts - Last 10 workouts with key metrics
- hevy://exercise-list - Simple exercise reference list

API Documentation

This server interfaces with the Hevy API v1. You'll need a valid Hevy API key to use this server.

Development

$3


`bash
npm install
`

$3

`bash
npm run build
`

$3

`bash
npm test
`

$3

`bash
npm run dev
``

License

MIT

Repository

https://github.com/noah-vh/hevy-mcp-server