hevy-mcp 1.15.0 → 1.17.0

package/README.md

@@ -130,7 +130,8 @@ pnpm start -- --hevy-api-key=your_hevy_api_key_here
 `hevy-mcp` ships with Sentry monitoring baked into the built MCP server so
 that usage and errors from published builds can be observed.
 
-The server initializes `@sentry/node` with a fixed DSN and tracing settings
+The server initializes `@sentry/node` with a fixed DSN, release name derived
+from the package version, and tracing settings
 directly in the code (see `src/index.ts`), and wraps the underlying
 `McpServer` with `Sentry.wrapMcpServerWithSentry` so requests and tool calls
 are captured by Sentry automatically. The configuration uses

package/dist/cli.js

@@ -9,10 +9,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z as z6 } from "zod";
 
-// package.json
-var name = "hevy-mcp";
-var version = "1.14.4";
-
 // src/tools/folders.ts
 import { z } from "zod";
 
@@ -165,6 +161,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 }) {
@@ -553,6 +565,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
@@ -594,7 +739,7 @@ function registerWebhookTools(server, hevyClient) {
           "API client not initialized. Please provide HEVY_API_KEY."
         );
       }
-      if (!("getWebhookSubscription" in hevyClient)) {
+      if (!hevyClient.getWebhookSubscription) {
         throw new Error(
           "Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec."
         );
@@ -627,7 +772,7 @@ function registerWebhookTools(server, hevyClient) {
         );
       }
       const { url, authToken } = args;
-      if (!("createWebhookSubscription" in hevyClient)) {
+      if (!hevyClient.createWebhookSubscription) {
         throw new Error(
           "Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec."
         );
@@ -657,7 +802,7 @@ function registerWebhookTools(server, hevyClient) {
           "API client not initialized. Please provide HEVY_API_KEY."
         );
       }
-      if (!("deleteWebhookSubscription" in hevyClient)) {
+      if (!hevyClient.deleteWebhookSubscription) {
         throw new Error(
           "Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec."
         );
@@ -776,6 +921,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({
@@ -810,31 +956,31 @@ function registerWorkoutTools(server, hevyClient) {
         );
       }
       const { title, description, startTime, endTime, isPrivate, exercises } = args;
-      const requestBody = {
-        workout: {
-          title,
-          description: description || null,
-          start_time: startTime,
-          end_time: endTime,
-          is_private: isPrivate,
-          exercises: exercises.map(
-            (exercise) => ({
-              exercise_template_id: exercise.exerciseTemplateId,
-              superset_id: exercise.supersetId ?? null,
-              notes: exercise.notes ?? null,
-              sets: exercise.sets.map((set) => ({
-                type: set.type,
-                weight_kg: set.weight ?? set.weightKg ?? null,
-                reps: set.reps ?? null,
-                distance_meters: set.distance ?? set.distanceMeters ?? null,
-                duration_seconds: set.duration ?? set.durationSeconds ?? null,
-                rpe: set.rpe ?? null,
-                custom_metric: set.customMetric ?? null
-              }))
-            })
-          )
-        }
+      const workoutPayload = {
+        title,
+        description: description || null,
+        start_time: startTime,
+        end_time: endTime,
+        routine_id: args.routineId ?? null,
+        is_private: isPrivate,
+        exercises: exercises.map(
+          (exercise) => ({
+            exercise_template_id: exercise.exerciseTemplateId,
+            superset_id: exercise.supersetId ?? null,
+            notes: exercise.notes ?? null,
+            sets: exercise.sets.map((set) => ({
+              type: set.type,
+              weight_kg: set.weight ?? set.weightKg ?? null,
+              reps: set.reps ?? null,
+              distance_meters: set.distance ?? set.distanceMeters ?? null,
+              duration_seconds: set.duration ?? set.durationSeconds ?? null,
+              rpe: set.rpe ?? null,
+              custom_metric: set.customMetric ?? null
+            }))
+          })
+        )
       };
+      const requestBody = { workout: workoutPayload };
       const data = await hevyClient.createWorkout(requestBody);
       if (!data) {
         return createEmptyResponse(
@@ -854,6 +1000,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({
@@ -893,34 +1040,35 @@ function registerWorkoutTools(server, hevyClient) {
         description,
         startTime,
         endTime,
+        routineId,
         isPrivate,
         exercises
       } = args;
-      const requestBody = {
-        workout: {
-          title,
-          description: description || null,
-          start_time: startTime,
-          end_time: endTime,
-          is_private: isPrivate,
-          exercises: exercises.map(
-            (exercise) => ({
-              exercise_template_id: exercise.exerciseTemplateId,
-              superset_id: exercise.supersetId ?? null,
-              notes: exercise.notes ?? null,
-              sets: exercise.sets.map((set) => ({
-                type: set.type,
-                weight_kg: set.weight ?? set.weightKg ?? null,
-                reps: set.reps ?? null,
-                distance_meters: set.distance ?? set.distanceMeters ?? null,
-                duration_seconds: set.duration ?? set.durationSeconds ?? null,
-                rpe: set.rpe ?? null,
-                custom_metric: set.customMetric ?? null
-              }))
-            })
-          )
-        }
+      const workoutPayload = {
+        title,
+        description: description || null,
+        start_time: startTime,
+        end_time: endTime,
+        routine_id: routineId ?? null,
+        is_private: isPrivate,
+        exercises: exercises.map(
+          (exercise) => ({
+            exercise_template_id: exercise.exerciseTemplateId,
+            superset_id: exercise.supersetId ?? null,
+            notes: exercise.notes ?? null,
+            sets: exercise.sets.map((set) => ({
+              type: set.type,
+              weight_kg: set.weight ?? set.weightKg ?? null,
+              reps: set.reps ?? null,
+              distance_meters: set.distance ?? set.distanceMeters ?? null,
+              duration_seconds: set.duration ?? set.durationSeconds ?? null,
+              rpe: set.rpe ?? null,
+              custom_metric: set.customMetric ?? null
+            }))
+          })
+        )
       };
+      const requestBody = { workout: workoutPayload };
       const data = await hevyClient.updateWorkout(workoutId, requestBody);
       if (!data) {
         return createEmptyResponse(
@@ -973,15 +1121,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;
 }
 
@@ -1057,66 +1205,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() {
@@ -1143,53 +1292,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;
@@ -1229,16 +1365,34 @@ 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 }),
     getRoutineFolder: (folderId) => getV1RoutineFoldersFolderid(folderId, headers, {
       client
     }),
-    // Webhooks
-    getWebhookSubscription: () => getV1WebhookSubscription(headers, { client }),
-    createWebhookSubscription: (data) => postV1WebhookSubscription(headers, data, { client }),
-    deleteWebhookSubscription: () => deleteV1WebhookSubscription(headers, { client })
+    getWebhookSubscription: async () => {
+      throw new Error(
+        "Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec."
+      );
+    },
+    createWebhookSubscription: async (_data) => {
+      throw new Error(
+        "Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec."
+      );
+    },
+    deleteWebhookSubscription: async () => {
+      throw new Error(
+        "Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec."
+      );
+    }
   };
 }
 
@@ -1248,9 +1402,19 @@ function createClient2(apiKey, baseUrl) {
 }
 
 // src/index.ts
+var isBuiltArtifact = true ? true : false;
+if (isBuiltArtifact && false) {
+  throw new Error(
+    "Build-time variables __HEVY_MCP_NAME__ and __HEVY_MCP_VERSION__ must be defined."
+  );
+}
+var name = true ? "hevy-mcp" : "hevy-mcp";
+var version = true ? "1.16.0" : "dev";
 dotenvx.config({ quiet: true });
+var sentryRelease = process.env.SENTRY_RELEASE ?? `${name}@${version}`;
 var sentryConfig = {
   dsn: "https://ce696d8333b507acbf5203eb877bce0f@o4508975499575296.ingest.de.sentry.io/4509049671647312",
+  release: sentryRelease,
   // Tracing must be enabled for MCP monitoring to work
   tracesSampleRate: 1,
   sendDefaultPii: false