Hevy MCP

🚀 hevy-api-mcp

MCP server for the Hevy API, facilitating seamless interaction with the Hevy API.

🚀 Quick Start

This is an MCP server designed for the Hevy API, enabling efficient interaction with the Hevy API.

📦 Installation

1. Clone the repository and navigate to the directory:

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

2. Install dependencies and build:

   npm install
   npm run build
   

💻 Usage Examples

Basic Usage

You can run the MCP server using npx (locally or globally, if published to npm):

npx hevy-api-mcp

Advanced Usage

Or from your MCP config:

{
  "mcpServers": {
    "hevy-api-mcp": {
      "command": "npx",
      "args": ["-y", "hevy-api-mcp"],
      "env": {
        "HEVY_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Another Usage Example

You can test the server locally:

HEVY_API_KEY=your_api_key npx hevy-api-mcp

Or using the .env file:

npx hevy-api-mcp

📚 Documentation

Environment variables

• HEVY_API_KEY: Your Hevy API key (required). You can use a .env file for local development:

HEVY_API_KEY=your_api_key

Exposed tools

• getWorkouts
• getWorkoutById
• createWorkout
• updateWorkout
• getRoutineFolders
• getRoutineFolderById
• createRoutineFolder
• getExerciseTemplates
• getExerciseTemplateById
• getWebhookSubscription
• createWebhookSubscription
• deleteWebhookSubscription

For questions or suggestions, open an issue in the repository.