About Hevy MCP Ts
Hevy MCP Ts is an MCP server published by amilz in the Developer Tools category: a TypeScript MCP Server for interacting with Hevy Workout App in LLMs.
The repository has 2 stars and 0 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/amilz/hevy-mcp-tsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Hevy MCP Ts
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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.
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
- Node.js (v18 or higher)
- Hevy API key (Hevy Settings)
- An LLM that supports the Model Context Protocol (e.g., Claude Desktop)
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
- @modelcontextprotocol/sdk: MCP SDK for creating model context protocol servers
- zod: TypeScript-first schema validation
README fetched from the repository 7 days ago. The original is authoritative.