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

Global Installation (Recommended)

npm install -g hevy-mcp-server

Local Installation

npm install hevy-mcp-server

Quick Start

1. Set your Hevy API key

   export HEVY_API_KEY=your_hevy_api_key_here

2. Run the server

   hevy-mcp-server

MCP Configuration

Claude Desktop App

Add this to your Claude Desktop configuration file:

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

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

Other MCP Clients

For other MCP clients, use:

HEVY_API_KEY=your_key hevy-mcp-server

MCP Tools Available

Workout Tools

• 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

Routine Tools

• 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

Exercise Tools

• 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

Setup

npm install

Build

npm run build

Test

npm test

Development Mode

npm run dev

License

MIT

Repository

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