A Model Context Protocol (MCP) server that provides access to workout data from Hevy, a popular weightlifting and workout tracking application.

This MCP server allows AI assistants like Claude to query and retrieve workout data from your Hevy account, enabling natural language interactions with your fitness history.

• get_workout_count: Get the total number of workouts in your Hevy account
• get_workouts: Retrieve your workouts from newest to oldest with pagination support
  • Default limit: 5 workouts
  • Maximum limit: 10 workouts per request
  • Supports offset for pagination

• A Hevy account with API access
• Hevy API key

Download the latest release for your platform from the releases page:

• Linux: hevy-mcp_Linux_x86_64.tar.gz
• macOS (Intel): hevy-mcp_Darwin_x86_64.tar.gz
• macOS (Apple Silicon): hevy-mcp_Darwin_arm64.tar.gz
• Windows: hevy-mcp_Windows_x86_64.zip

Extract the archive and you're ready to use the hevy-mcp binary.

Requirements: Go 1.25.1 or higher

1. Clone the repository:

git clone https://github.com/swrm-io/hevy-mcp.git
cd hevy-mcp

2. Build the server:

go build -o hevy-mcp

• HEVY_API_KEY (required): Your Hevy API key

Add this configuration to your Claude Desktop config file:

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

{
  "mcpServers": {
    "hevy": {
      "command": "/path/to/hevy-mcp",
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

export HEVY_API_KEY="your-api-key-here"
./hevy-mcp

Once configured with Claude Desktop, you can ask questions like:

• "How many workouts do I have in Hevy?"
• "Show me my last 5 workouts"
• "What exercises did I do in my recent workouts?"

The server is built using:

• go-sdk - Official MCP SDK for Go
• go-hevy - Hevy API client library

• main.go - Server initialization and tool registration
• types.go - Type definitions for requests and service
• workouts.go - Workout-related tool implementations

See LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.