hevy-mcp-ts

hevy-mcp-ts

1
ai_chatbotdeveloper_toolshealth_and_fitness

Hevy MCP is a TypeScript implementation of a Model Context Protocol server, offering integration with the Hevy workout tracking API. It enables AI tools to analyze and provide insights into users' workout data, enhancing fitness tracking and planning.

Hevy MCP

A TypeScript Model Context Protocol (MCP) server implementation for interacting with the Hevy workout tracking API.

Overview

Hevy MCP provides AI assistants with access to your Hevy workout data through the Model Context Protocol. This server enables AI tools to retrieve and analyze your workout history, helping you gain insights into your fitness journey.

Hevy MCP

Features

  • Retrieves workout history from Hevy API
  • Implements the Model Context Protocol for AI assistant integration
  • Simple setup with configurable options

API Tools

At present, the MCP server provides the following tools:

  • getWorkouts: Retrieve user workouts with pagination

(I haven't convinced myself that additional methods will be useful with the LLM--if you have ideas/thoughts, drop an issue or PR!)

Requirements

Installation

Clone the repository

git clone https://github.com/amilz/hevy-mcp.git && cd hevy-mcp

Install dependencies

npm install

Build the TypeScript code:

npm run build

Configuration

Before using the application, you need to set up your Hevy API key in your LLM (example for Claude Desktop). Your Claude Desktop config file should look like this:

{
    "mcpServers": {
        "hevy": {
            "command": "node",
            "args": [
                "/path/to/hevy-mcp/build/src/index.js"
            ],
            "env": {
                "HEVY_API_KEY": "xyz"
            }
        }
    }
}

Usage

Restart your LLM Environment to apply the changes. Try a simple query like "Summarize my last 5 workouts" or "based on my last 10 workouts, could you recommend a workout for today?"

Dependencies