README.md•1.3 kB
# hevy-api-mcp
MCP server for the Hevy API
## Installation
1. Clone the repository and navigate to the directory:
```sh
git clone https://github.com/jcjiron/hevy-mcp.git
cd hevy-mcp
```
2. Install dependencies and build:
```sh
npm install
npm run build
```
## Usage with npx
You can run the MCP server using npx (locally or globally, if published to npm):
```sh
npx hevy-api-mcp
```
Or from your MCP config:
```json
{
"mcpServers": {
"hevy-api-mcp": {
"command": "npx",
"args": ["-y", "hevy-api-mcp"],
"env": {
"HEVY_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
```
## 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
## Usage example
You can test the server locally:
```sh
HEVY_API_KEY=your_api_key npx hevy-api-mcp
```
Or using the `.env` file:
```sh
npx hevy-api-mcp
```
---
For questions or suggestions, open an issue in the repository.