hevy-mcp 1.14.4 → 1.16.0

package/dist/cli.js

@@ -11,7 +11,7 @@ import { z as z6 } from "zod";
 
 // package.json
 var name = "hevy-mcp";
-var version = "1.14.3";
+var version = "1.15.0";
 
 // src/tools/folders.ts
 import { z } from "zod";
@@ -165,6 +165,22 @@ function formatExerciseTemplate(template) {
     isCustom: template.is_custom
   };
 }
+function formatExerciseHistoryEntry(entry) {
+  return {
+    workoutId: entry.workout_id,
+    workoutTitle: entry.workout_title,
+    workoutStartTime: entry.workout_start_time,
+    workoutEndTime: entry.workout_end_time,
+    exerciseTemplateId: entry.exercise_template_id,
+    weight: entry.weight_kg,
+    reps: entry.reps,
+    distance: entry.distance_meters,
+    duration: entry.duration_seconds,
+    rpe: entry.rpe,
+    customMetric: entry.custom_metric,
+    setType: entry.set_type
+  };
+}
 
 // src/utils/response-formatter.ts
 function createJsonResponse(data, options = { pretty: true, indent: 2 }) {
@@ -351,7 +367,11 @@ function registerRoutineTools(server, hevyClient) {
             distanceMeters: z2.coerce.number().int().optional(),
             duration: z2.coerce.number().int().optional(),
             durationSeconds: z2.coerce.number().int().optional(),
-            customMetric: z2.coerce.number().optional()
+            customMetric: z2.coerce.number().optional(),
+            repRange: z2.object({
+              start: z2.coerce.number().int().optional(),
+              end: z2.coerce.number().int().optional()
+            }).optional()
           })
         )
       })
@@ -386,7 +406,11 @@ function registerRoutineTools(server, hevyClient) {
                   reps: set.reps ?? null,
                   distance_meters: set.distance ?? set.distanceMeters ?? null,
                   duration_seconds: set.duration ?? set.durationSeconds ?? null,
-                  custom_metric: set.customMetric ?? null
+                  custom_metric: set.customMetric ?? null,
+                  rep_range: set.repRange ? {
+                    start: set.repRange.start ?? null,
+                    end: set.repRange.end ?? null
+                  } : null
                 })
               )
             })
@@ -425,7 +449,11 @@ function registerRoutineTools(server, hevyClient) {
             distanceMeters: z2.coerce.number().int().optional(),
             duration: z2.coerce.number().int().optional(),
             durationSeconds: z2.coerce.number().int().optional(),
-            customMetric: z2.coerce.number().optional()
+            customMetric: z2.coerce.number().optional(),
+            repRange: z2.object({
+              start: z2.coerce.number().int().optional(),
+              end: z2.coerce.number().int().optional()
+            }).optional()
           })
         )
       })
@@ -459,7 +487,11 @@ function registerRoutineTools(server, hevyClient) {
                   reps: set.reps ?? null,
                   distance_meters: set.distance ?? set.distanceMeters ?? null,
                   duration_seconds: set.duration ?? set.durationSeconds ?? null,
-                  custom_metric: set.customMetric ?? null
+                  custom_metric: set.customMetric ?? null,
+                  rep_range: set.repRange ? {
+                    start: set.repRange.start ?? null,
+                    end: set.repRange.end ?? null
+                  } : null
                 })
               )
             })
@@ -537,6 +569,139 @@ function registerTemplateTools(server, hevyClient) {
       return createJsonResponse(template);
     }, "get-exercise-template")
   );
+  const getExerciseHistorySchema = {
+    exerciseTemplateId: z3.string().min(1),
+    startDate: z3.string().datetime({ offset: true }).describe("ISO 8601 start date for filtering history").optional(),
+    endDate: z3.string().datetime({ offset: true }).describe("ISO 8601 end date for filtering history").optional()
+  };
+  server.tool(
+    "get-exercise-history",
+    "Get past sets for a specific exercise template, optionally filtered by start and end dates.",
+    getExerciseHistorySchema,
+    withErrorHandling(async (args) => {
+      if (!hevyClient) {
+        throw new Error(
+          "API client not initialized. Please provide HEVY_API_KEY."
+        );
+      }
+      const { exerciseTemplateId, startDate, endDate } = args;
+      const data = await hevyClient.getExerciseHistory(exerciseTemplateId, {
+        ...startDate ? { start_date: startDate } : {},
+        ...endDate ? { end_date: endDate } : {}
+      });
+      const history = data?.exercise_history?.map(
+        (entry) => formatExerciseHistoryEntry(entry)
+      ) || [];
+      if (history.length === 0) {
+        return createEmptyResponse(
+          `No exercise history found for template ${exerciseTemplateId}`
+        );
+      }
+      return createJsonResponse(history);
+    }, "get-exercise-history")
+  );
+  const createExerciseTemplateSchema = {
+    title: z3.string().min(1),
+    exerciseType: z3.enum([
+      "weight_reps",
+      "reps_only",
+      "bodyweight_reps",
+      "bodyweight_assisted_reps",
+      "duration",
+      "weight_duration",
+      "distance_duration",
+      "short_distance_weight"
+    ]),
+    equipmentCategory: z3.enum([
+      "none",
+      "barbell",
+      "dumbbell",
+      "kettlebell",
+      "machine",
+      "plate",
+      "resistance_band",
+      "suspension",
+      "other"
+    ]),
+    muscleGroup: z3.enum([
+      "abdominals",
+      "shoulders",
+      "biceps",
+      "triceps",
+      "forearms",
+      "quadriceps",
+      "hamstrings",
+      "calves",
+      "glutes",
+      "abductors",
+      "adductors",
+      "lats",
+      "upper_back",
+      "traps",
+      "lower_back",
+      "chest",
+      "cardio",
+      "neck",
+      "full_body",
+      "other"
+    ]),
+    otherMuscles: z3.array(
+      z3.enum([
+        "abdominals",
+        "shoulders",
+        "biceps",
+        "triceps",
+        "forearms",
+        "quadriceps",
+        "hamstrings",
+        "calves",
+        "glutes",
+        "abductors",
+        "adductors",
+        "lats",
+        "upper_back",
+        "traps",
+        "lower_back",
+        "chest",
+        "cardio",
+        "neck",
+        "full_body",
+        "other"
+      ])
+    ).default([])
+  };
+  server.tool(
+    "create-exercise-template",
+    "Create a custom exercise template with title, type, equipment, and muscle groups.",
+    createExerciseTemplateSchema,
+    withErrorHandling(async (args) => {
+      if (!hevyClient) {
+        throw new Error(
+          "API client not initialized. Please provide HEVY_API_KEY."
+        );
+      }
+      const {
+        title,
+        exerciseType,
+        equipmentCategory,
+        muscleGroup,
+        otherMuscles
+      } = args;
+      const response = await hevyClient.createExerciseTemplate({
+        exercise: {
+          title,
+          exercise_type: exerciseType,
+          equipment_category: equipmentCategory,
+          muscle_group: muscleGroup,
+          other_muscles: otherMuscles
+        }
+      });
+      return createJsonResponse({
+        id: response?.id,
+        message: "Exercise template created successfully"
+      });
+    }, "create-exercise-template")
+  );
 }
 
 // src/tools/webhooks.ts
@@ -760,6 +925,7 @@ function registerWorkoutTools(server, hevyClient) {
     description: z5.string().optional().nullable(),
     startTime: z5.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/),
     endTime: z5.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/),
+    routineId: z5.string().optional().nullable(),
     isPrivate: z5.boolean().default(false),
     exercises: z5.array(
       z5.object({
@@ -800,6 +966,7 @@ function registerWorkoutTools(server, hevyClient) {
           description: description || null,
           start_time: startTime,
           end_time: endTime,
+          routine_id: args.routineId ?? null,
           is_private: isPrivate,
           exercises: exercises.map(
             (exercise) => ({
@@ -838,6 +1005,7 @@ function registerWorkoutTools(server, hevyClient) {
     description: z5.string().optional().nullable(),
     startTime: z5.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/),
     endTime: z5.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/),
+    routineId: z5.string().optional().nullable(),
     isPrivate: z5.boolean().default(false),
     exercises: z5.array(
       z5.object({
@@ -877,6 +1045,7 @@ function registerWorkoutTools(server, hevyClient) {
         description,
         startTime,
         endTime,
+        routineId,
         isPrivate,
         exercises
       } = args;
@@ -886,6 +1055,7 @@ function registerWorkoutTools(server, hevyClient) {
           description: description || null,
           start_time: startTime,
           end_time: endTime,
+          routine_id: routineId ?? null,
           is_private: isPrivate,
           exercises: exercises.map(
             (exercise) => ({
@@ -957,15 +1127,15 @@ function assertApiKey(apiKey) {
 // src/utils/hevyClientKubb.ts
 import axios from "axios";
 
-// src/generated/client/api/deleteV1WebhookSubscription.ts
+// src/generated/client/api/getV1ExerciseHistoryExercisetemplateid.ts
 import fetch from "@kubb/plugin-client/clients/axios";
-function getDeleteV1WebhookSubscriptionUrl() {
-  const res = { method: "DELETE", url: `/v1/webhook-subscription` };
+function getGetV1ExerciseHistoryExercisetemplateidUrl(exerciseTemplateId) {
+  const res = { method: "GET", url: `/v1/exercise_history/${exerciseTemplateId}` };
   return res;
 }
-async function deleteV1WebhookSubscription(headers, config = {}) {
+async function getV1ExerciseHistoryExercisetemplateid(exerciseTemplateId, headers, params, config = {}) {
   const { client: request = fetch, ...requestConfig } = config;
-  const res = await request({ method: "DELETE", url: getDeleteV1WebhookSubscriptionUrl().url.toString(), ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
+  const res = await request({ method: "GET", url: getGetV1ExerciseHistoryExercisetemplateidUrl(exerciseTemplateId).url.toString(), params, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
@@ -1041,66 +1211,67 @@ async function getV1RoutinesRoutineid(routineId, headers, config = {}) {
   return res.data;
 }
 
-// src/generated/client/api/getV1WebhookSubscription.ts
-import fetch8 from "@kubb/plugin-client/clients/axios";
-function getGetV1WebhookSubscriptionUrl() {
-  const res = { method: "GET", url: `/v1/webhook-subscription` };
-  return res;
-}
-async function getV1WebhookSubscription(headers, config = {}) {
-  const { client: request = fetch8, ...requestConfig } = config;
-  const res = await request({ method: "GET", url: getGetV1WebhookSubscriptionUrl().url.toString(), ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
-  return res.data;
-}
-
 // src/generated/client/api/getV1Workouts.ts
-import fetch9 from "@kubb/plugin-client/clients/axios";
+import fetch8 from "@kubb/plugin-client/clients/axios";
 function getGetV1WorkoutsUrl() {
   const res = { method: "GET", url: `/v1/workouts` };
   return res;
 }
 async function getV1Workouts(headers, params, config = {}) {
-  const { client: request = fetch9, ...requestConfig } = config;
+  const { client: request = fetch8, ...requestConfig } = config;
   const res = await request({ method: "GET", url: getGetV1WorkoutsUrl().url.toString(), params, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
 // src/generated/client/api/getV1WorkoutsCount.ts
-import fetch10 from "@kubb/plugin-client/clients/axios";
+import fetch9 from "@kubb/plugin-client/clients/axios";
 function getGetV1WorkoutsCountUrl() {
   const res = { method: "GET", url: `/v1/workouts/count` };
   return res;
 }
 async function getV1WorkoutsCount(headers, config = {}) {
-  const { client: request = fetch10, ...requestConfig } = config;
+  const { client: request = fetch9, ...requestConfig } = config;
   const res = await request({ method: "GET", url: getGetV1WorkoutsCountUrl().url.toString(), ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
 // src/generated/client/api/getV1WorkoutsEvents.ts
-import fetch11 from "@kubb/plugin-client/clients/axios";
+import fetch10 from "@kubb/plugin-client/clients/axios";
 function getGetV1WorkoutsEventsUrl() {
   const res = { method: "GET", url: `/v1/workouts/events` };
   return res;
 }
 async function getV1WorkoutsEvents(headers, params, config = {}) {
-  const { client: request = fetch11, ...requestConfig } = config;
+  const { client: request = fetch10, ...requestConfig } = config;
   const res = await request({ method: "GET", url: getGetV1WorkoutsEventsUrl().url.toString(), params, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
 // src/generated/client/api/getV1WorkoutsWorkoutid.ts
-import fetch12 from "@kubb/plugin-client/clients/axios";
+import fetch11 from "@kubb/plugin-client/clients/axios";
 function getGetV1WorkoutsWorkoutidUrl(workoutId) {
   const res = { method: "GET", url: `/v1/workouts/${workoutId}` };
   return res;
 }
 async function getV1WorkoutsWorkoutid(workoutId, headers, config = {}) {
-  const { client: request = fetch12, ...requestConfig } = config;
+  const { client: request = fetch11, ...requestConfig } = config;
   const res = await request({ method: "GET", url: getGetV1WorkoutsWorkoutidUrl(workoutId).url.toString(), ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
+// src/generated/client/api/postV1ExerciseTemplates.ts
+import fetch12 from "@kubb/plugin-client/clients/axios";
+function getPostV1ExerciseTemplatesUrl() {
+  const res = { method: "POST", url: `/v1/exercise_templates` };
+  return res;
+}
+async function postV1ExerciseTemplates(headers, data, config = {}) {
+  const { client: request = fetch12, ...requestConfig } = config;
+  const requestData = data;
+  const res = await request({ method: "POST", url: getPostV1ExerciseTemplatesUrl().url.toString(), data: requestData, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
+  return res.data;
+}
+
 // src/generated/client/api/postV1RoutineFolders.ts
 import fetch13 from "@kubb/plugin-client/clients/axios";
 function getPostV1RoutineFoldersUrl() {
@@ -1127,53 +1298,40 @@ async function postV1Routines(headers, data, config = {}) {
   return res.data;
 }
 
-// src/generated/client/api/postV1WebhookSubscription.ts
-import fetch15 from "@kubb/plugin-client/clients/axios";
-function getPostV1WebhookSubscriptionUrl() {
-  const res = { method: "POST", url: `/v1/webhook-subscription` };
-  return res;
-}
-async function postV1WebhookSubscription(headers, data, config = {}) {
-  const { client: request = fetch15, ...requestConfig } = config;
-  const requestData = data;
-  const res = await request({ method: "POST", url: getPostV1WebhookSubscriptionUrl().url.toString(), data: requestData, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
-  return res.data;
-}
-
 // src/generated/client/api/postV1Workouts.ts
-import fetch16 from "@kubb/plugin-client/clients/axios";
+import fetch15 from "@kubb/plugin-client/clients/axios";
 function getPostV1WorkoutsUrl() {
   const res = { method: "POST", url: `/v1/workouts` };
   return res;
 }
 async function postV1Workouts(headers, data, config = {}) {
-  const { client: request = fetch16, ...requestConfig } = config;
+  const { client: request = fetch15, ...requestConfig } = config;
   const requestData = data;
   const res = await request({ method: "POST", url: getPostV1WorkoutsUrl().url.toString(), data: requestData, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
 // src/generated/client/api/putV1RoutinesRoutineid.ts
-import fetch17 from "@kubb/plugin-client/clients/axios";
+import fetch16 from "@kubb/plugin-client/clients/axios";
 function getPutV1RoutinesRoutineidUrl(routineId) {
   const res = { method: "PUT", url: `/v1/routines/${routineId}` };
   return res;
 }
 async function putV1RoutinesRoutineid(routineId, headers, data, config = {}) {
-  const { client: request = fetch17, ...requestConfig } = config;
+  const { client: request = fetch16, ...requestConfig } = config;
   const requestData = data;
   const res = await request({ method: "PUT", url: getPutV1RoutinesRoutineidUrl(routineId).url.toString(), data: requestData, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
 }
 
 // src/generated/client/api/putV1WorkoutsWorkoutid.ts
-import fetch18 from "@kubb/plugin-client/clients/axios";
+import fetch17 from "@kubb/plugin-client/clients/axios";
 function getPutV1WorkoutsWorkoutidUrl(workoutId) {
   const res = { method: "PUT", url: `/v1/workouts/${workoutId}` };
   return res;
 }
 async function putV1WorkoutsWorkoutid(workoutId, headers, data, config = {}) {
-  const { client: request = fetch18, ...requestConfig } = config;
+  const { client: request = fetch17, ...requestConfig } = config;
   const requestData = data;
   const res = await request({ method: "PUT", url: getPutV1WorkoutsWorkoutidUrl(workoutId).url.toString(), data: requestData, ...requestConfig, headers: { ...headers, ...requestConfig.headers } });
   return res.data;
@@ -1213,6 +1371,13 @@ function createClient(apiKey, baseUrl = "https://api.hevyapp.com") {
     getExerciseTemplate: (templateId) => getV1ExerciseTemplatesExercisetemplateid(templateId, headers, {
       client
     }),
+    getExerciseHistory: (exerciseTemplateId, params) => getV1ExerciseHistoryExercisetemplateid(
+      exerciseTemplateId,
+      headers,
+      params,
+      { client }
+    ),
+    createExerciseTemplate: (data) => postV1ExerciseTemplates(headers, data, { client }),
     // Routine Folders
     getRoutineFolders: (params) => getV1RoutineFolders(headers, params, { client }),
     createRoutineFolder: (data) => postV1RoutineFolders(headers, data, { client }),
@@ -1220,9 +1385,9 @@ function createClient(apiKey, baseUrl = "https://api.hevyapp.com") {
       client
     }),
     // Webhooks
-    getWebhookSubscription: () => getV1WebhookSubscription(headers, { client }),
-    createWebhookSubscription: (data) => postV1WebhookSubscription(headers, data, { client }),
-    deleteWebhookSubscription: () => deleteV1WebhookSubscription(headers, { client })
+    getWebhookSubscription: () => (void 0)(headers, { client }),
+    createWebhookSubscription: (data) => (void 0)(headers, data, { client }),
+    deleteWebhookSubscription: () => (void 0)(headers, { client })
   };
 }