hevy-mcp 1.1.0 → 1.2.0

package/dist/index.js

@@ -9,12 +9,96 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/tools/folders.ts
 import { z } from "zod";
+
+// src/utils/formatters.ts
+function formatWorkout(workout) {
+  return {
+    id: workout.id,
+    date: workout.createdAt,
+    name: workout.title,
+    description: workout.description,
+    duration: calculateDuration(workout.startTime || "", workout.endTime || ""),
+    exercises: workout.exercises?.map((exercise) => {
+      return {
+        name: exercise.title,
+        notes: exercise.notes,
+        sets: exercise.sets?.map((set) => ({
+          type: set.type,
+          weight: set.weightKg,
+          reps: set.reps,
+          distance: set.distanceMeters,
+          duration: set.durationSeconds,
+          rpe: set.rpe,
+          customMetric: set.customMetric
+        }))
+      };
+    })
+  };
+}
+function formatRoutine(routine) {
+  return {
+    id: routine.id,
+    title: routine.title,
+    folderId: routine.folderId,
+    createdAt: routine.createdAt,
+    updatedAt: routine.updatedAt,
+    exercises: routine.exercises?.map((exercise) => {
+      return {
+        name: exercise.title,
+        index: exercise.index,
+        exerciseTemplateId: exercise.exerciseTemplateId,
+        notes: exercise.notes,
+        supersetId: exercise.supersetsId,
+        sets: exercise.sets?.map((set) => ({
+          index: set.index,
+          type: set.type,
+          weight: set.weightKg,
+          reps: set.reps,
+          distance: set.distanceMeters,
+          duration: set.durationSeconds,
+          customMetric: set.customMetric
+        }))
+      };
+    })
+  };
+}
+function formatRoutineFolder(folder) {
+  return {
+    id: folder.id,
+    title: folder.title,
+    createdAt: folder.createdAt,
+    updatedAt: folder.updatedAt
+  };
+}
+function calculateDuration(startTime, endTime) {
+  if (!startTime || !endTime) return "Unknown duration";
+  const start = new Date(startTime);
+  const end = new Date(endTime);
+  const durationMs = end.getTime() - start.getTime();
+  const hours = Math.floor(durationMs / (1e3 * 60 * 60));
+  const minutes = Math.floor(durationMs % (1e3 * 60 * 60) / (1e3 * 60));
+  const seconds = Math.floor(durationMs % (1e3 * 60) / 1e3);
+  return `${hours}h ${minutes}m ${seconds}s`;
+}
+function formatExerciseTemplate(template) {
+  return {
+    id: template.id,
+    title: template.title,
+    type: template.type,
+    primaryMuscleGroup: template.primaryMuscleGroup,
+    secondaryMuscleGroups: template.secondaryMuscleGroups,
+    isCustom: template.isCustom
+  };
+}
+
+// src/tools/folders.ts
 function registerFolderTools(server2, hevyClient2) {
   server2.tool(
     "get-routine-folders",
+    "Get a paginated list of routine folders available on the account. Returns folder details including ID, title, index (order position), and creation/update timestamps. Useful for organizing routines into categories.",
     {
-      page: z.number().int().gte(1).default(1),
-      pageSize: z.number().int().gte(1).lte(10).default(5)
+      page: z.coerce.number().int().gte(1).default(1),
+      pageSize: z.coerce.number().int().gte(1).lte(10).default(5)
     },
     async ({ page, pageSize }) => {
       try {
@@ -41,15 +125,17 @@ function registerFolderTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching routine folders: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "get-routine-folder",
+    "Get complete details of a specific routine folder by ID. Returns all folder information including title, index (order position), and creation/update timestamps.",
     {
-      folderId: z.number().int()
+      folderId: z.coerce.number().int()
     },
     async ({ folderId }) => {
       try {
@@ -81,13 +167,15 @@ function registerFolderTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching routine folder: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "create-routine-folder",
+    "Create a new routine folder in your Hevy account. The folder will be created at index 0, and all other folders will have their indexes incremented. Returns the complete folder details upon successful creation including the newly assigned folder ID.",
     {
       title: z.string().min(1)
     },
@@ -126,30 +214,23 @@ ${JSON.stringify(folder, null, 2)}`
               type: "text",
               text: `Error creating routine folder: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
 }
-function formatRoutineFolder(folder) {
-  return {
-    id: folder.id,
-    title: folder.title,
-    index: folder.index,
-    createdAt: folder.createdAt,
-    updatedAt: folder.updatedAt
-  };
-}
 
 // src/tools/routines.ts
 import { z as z2 } from "zod";
 function registerRoutineTools(server2, hevyClient2) {
   server2.tool(
     "get-routines",
+    "Get a paginated list of routines. Returns routine details including title, creation date, folder assignment, and exercise configurations. Results include both default and custom routines.",
     {
-      page: z2.number().int().gte(1).default(1),
-      pageSize: z2.number().int().gte(1).lte(10).default(5)
+      page: z2.coerce.number().int().gte(1).default(1),
+      pageSize: z2.coerce.number().int().gte(1).lte(10).default(5)
     },
     async ({ page, pageSize }) => {
       try {
@@ -176,22 +257,26 @@ function registerRoutineTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching routines: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "get-routine",
+    "Get complete details of a specific routine by ID. Returns all routine information including title, notes, assigned folder, and detailed exercise data with set configurations.",
     {
       routineId: z2.string().min(1)
     },
     async ({ routineId }) => {
       try {
-        const response = await hevyClient2.v1.routines.get();
-        const data = response?.routines?.find(
-          (routine2) => routine2.id === routineId
-        );
+        const data = await hevyClient2.v1.routines.byRoutineId(routineId).put({
+          routine: {
+            title: ""
+            // We're providing a minimal body as required by the API
+          }
+        });
         if (!data) {
           return {
             content: [
@@ -219,31 +304,33 @@ function registerRoutineTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching routine: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "create-routine",
+    "Create a new workout routine in your Hevy account. Requires title and at least one exercise with sets. Optionally assign to a specific folder. Returns the complete routine details upon successful creation including the newly assigned routine ID.",
     {
       title: z2.string().min(1),
-      folderId: z2.number().nullable().optional(),
+      folderId: z2.coerce.number().nullable().optional(),
       notes: z2.string().optional(),
       exercises: z2.array(
         z2.object({
           exerciseTemplateId: z2.string().min(1),
-          supersetId: z2.number().nullable().optional(),
-          restSeconds: z2.number().int().min(0).optional(),
+          supersetId: z2.coerce.number().nullable().optional(),
+          restSeconds: z2.coerce.number().int().min(0).optional(),
           notes: z2.string().optional(),
           sets: z2.array(
             z2.object({
               type: z2.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
-              weightKg: z2.number().optional(),
-              reps: z2.number().int().optional(),
-              distanceMeters: z2.number().int().optional(),
-              durationSeconds: z2.number().int().optional(),
-              customMetric: z2.number().optional()
+              weightKg: z2.coerce.number().optional(),
+              reps: z2.coerce.number().int().optional(),
+              distanceMeters: z2.coerce.number().int().optional(),
+              durationSeconds: z2.coerce.number().int().optional(),
+              customMetric: z2.coerce.number().optional()
             })
           )
         })
@@ -300,13 +387,15 @@ ${JSON.stringify(routine, null, 2)}`
               type: "text",
               text: `Error creating routine: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "update-routine",
+    "Update an existing workout routine by ID. You can modify the title, notes, and exercise data. Returns the updated routine with all changes applied. Note that you cannot change the folder assignment through this method.",
     {
       routineId: z2.string().min(1),
       title: z2.string().min(1),
@@ -314,17 +403,17 @@ ${JSON.stringify(routine, null, 2)}`
       exercises: z2.array(
         z2.object({
           exerciseTemplateId: z2.string().min(1),
-          supersetId: z2.number().nullable().optional(),
-          restSeconds: z2.number().int().min(0).optional(),
+          supersetId: z2.coerce.number().nullable().optional(),
+          restSeconds: z2.coerce.number().int().min(0).optional(),
           notes: z2.string().optional(),
           sets: z2.array(
             z2.object({
               type: z2.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
-              weightKg: z2.number().optional(),
-              reps: z2.number().int().optional(),
-              distanceMeters: z2.number().int().optional(),
-              durationSeconds: z2.number().int().optional(),
-              customMetric: z2.number().optional()
+              weightKg: z2.coerce.number().optional(),
+              reps: z2.coerce.number().int().optional(),
+              distanceMeters: z2.coerce.number().int().optional(),
+              durationSeconds: z2.coerce.number().int().optional(),
+              customMetric: z2.coerce.number().optional()
             })
           )
         })
@@ -380,48 +469,23 @@ ${JSON.stringify(routine, null, 2)}`
               type: "text",
               text: `Error updating routine: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
 }
-function formatRoutine(routine) {
-  return {
-    id: routine.id,
-    title: routine.title,
-    folderId: routine.folderId,
-    createdAt: routine.createdAt,
-    updatedAt: routine.updatedAt,
-    exercises: routine.exercises?.map((exercise) => {
-      return {
-        name: exercise.title,
-        index: exercise.index,
-        exerciseTemplateId: exercise.exerciseTemplateId,
-        notes: exercise.notes,
-        supersetId: exercise.supersetsId,
-        sets: exercise.sets?.map((set) => ({
-          index: set.index,
-          type: set.type,
-          weight: set.weightKg,
-          reps: set.reps,
-          distance: set.distanceMeters,
-          duration: set.durationSeconds,
-          customMetric: set.customMetric
-        }))
-      };
-    })
-  };
-}
 
 // src/tools/templates.ts
 import { z as z3 } from "zod";
 function registerTemplateTools(server2, hevyClient2) {
   server2.tool(
     "get-exercise-templates",
+    "Get a paginated list of exercise templates available on the account. Returns both default and custom exercise templates with details including title, type, primary muscle group, and secondary muscle groups. Supports up to 100 templates per page.",
     {
-      page: z3.number().int().gte(1).default(1),
-      pageSize: z3.number().int().gte(1).lte(100).default(20)
+      page: z3.coerce.number().int().gte(1).default(1),
+      pageSize: z3.coerce.number().int().gte(1).lte(100).default(20)
     },
     async ({ page, pageSize }) => {
       try {
@@ -450,13 +514,15 @@ function registerTemplateTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching exercise templates: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "get-exercise-template",
+    "Get complete details of a specific exercise template by ID. Returns all template information including title, type, primary muscle group, secondary muscle groups, and whether it's a custom exercise.",
     {
       exerciseTemplateId: z3.string().min(1)
     },
@@ -493,31 +559,23 @@ function registerTemplateTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching exercise template: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
 }
-function formatExerciseTemplate(template) {
-  return {
-    id: template.id,
-    title: template.title,
-    type: template.type,
-    primaryMuscleGroup: template.primaryMuscleGroup,
-    secondaryMuscleGroups: template.secondaryMuscleGroups,
-    isCustom: template.isCustom
-  };
-}
 
 // src/tools/workouts.ts
 import { z as z4 } from "zod";
 function registerWorkoutTools(server2, hevyClient2) {
   server2.tool(
     "get-workouts",
+    "Get a paginated list of workouts. Returns workout details including title, description, start/end times, and exercises performed. Results are ordered from newest to oldest.",
     {
-      page: z4.number().int().gte(1).default(1),
-      pageSize: z4.number().int().gte(1).lte(10).default(5)
+      page: z4.coerce.number().gte(1).default(1),
+      pageSize: z4.coerce.number().int().gte(1).lte(10).default(5)
     },
     async ({ page, pageSize }, extra) => {
       try {
@@ -544,13 +602,15 @@ function registerWorkoutTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching workouts: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "get-workout",
+    "Get complete details of a specific workout by ID. Returns all workout information including title, description, start/end times, and detailed exercise data.",
     {
       workoutId: z4.string().min(1)
     },
@@ -584,39 +644,47 @@ function registerWorkoutTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching workout: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
-  server2.tool("get-workout-count", {}, async (_, extra) => {
-    try {
-      const data = await hevyClient2.v1.workouts.count.get();
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Total workouts: ${data ? data.count || 0 : 0}`
-          }
-        ]
-      };
-    } catch (error) {
-      console.error("Error fetching workout count:", error);
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Error fetching workout count: ${error instanceof Error ? error.message : String(error)}`
-          }
-        ]
-      };
+  server2.tool(
+    "get-workout-count",
+    "Get the total number of workouts on the account. Useful for pagination or statistics.",
+    {},
+    async (_, extra) => {
+      try {
+        const data = await hevyClient2.v1.workouts.count.get();
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Total workouts: ${data ? data.count || 0 : 0}`
+            }
+          ]
+        };
+      } catch (error) {
+        console.error("Error fetching workout count:", error);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error fetching workout count: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
     }
-  });
+  );
   server2.tool(
     "get-workout-events",
+    "Retrieve a paged list of workout events (updates or deletes) since a given date. Events are ordered from newest to oldest. The intention is to allow clients to keep their local cache of workouts up to date without having to fetch the entire list of workouts.",
     {
-      page: z4.number().int().gte(1).default(1),
-      pageSize: z4.number().int().gte(1).lte(10).default(5),
+      page: z4.coerce.number().int().gte(1).default(1),
+      pageSize: z4.coerce.number().int().gte(1).lte(10).default(5),
       since: z4.string().default("1970-01-01T00:00:00Z")
     },
     async ({ page, pageSize, since }, extra) => {
@@ -644,13 +712,15 @@ function registerWorkoutTools(server2, hevyClient2) {
               type: "text",
               text: `Error fetching workout events: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "create-workout",
+    "Create a new workout in your Hevy account. Requires title, start/end times, and at least one exercise with sets. Returns the complete workout details upon successful creation including the newly assigned workout ID.",
     {
       title: z4.string().min(1),
       description: z4.string().optional().nullable(),
@@ -660,17 +730,17 @@ function registerWorkoutTools(server2, hevyClient2) {
       exercises: z4.array(
         z4.object({
           exerciseTemplateId: z4.string().min(1),
-          supersetId: z4.number().nullable().optional(),
+          supersetId: z4.coerce.number().nullable().optional(),
           notes: z4.string().optional().nullable(),
           sets: z4.array(
             z4.object({
               type: z4.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
-              weightKg: z4.number().optional().nullable(),
-              reps: z4.number().int().optional().nullable(),
-              distanceMeters: z4.number().int().optional().nullable(),
-              durationSeconds: z4.number().int().optional().nullable(),
-              rpe: z4.number().optional().nullable(),
-              customMetric: z4.number().optional().nullable()
+              weightKg: z4.coerce.number().optional().nullable(),
+              reps: z4.coerce.number().int().optional().nullable(),
+              distanceMeters: z4.coerce.number().int().optional().nullable(),
+              durationSeconds: z4.coerce.number().int().optional().nullable(),
+              rpe: z4.coerce.number().optional().nullable(),
+              customMetric: z4.coerce.number().optional().nullable()
             })
           )
         })
@@ -730,13 +800,15 @@ ${JSON.stringify(workout, null, 2)}`
               type: "text",
               text: `Error creating workout: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
   server2.tool(
     "update-workout",
+    "Update an existing workout by ID. You can modify the title, description, start/end times, privacy setting, and exercise data. Returns the updated workout with all changes applied.",
     {
       workoutId: z4.string().min(1),
       title: z4.string().min(1),
@@ -747,17 +819,17 @@ ${JSON.stringify(workout, null, 2)}`
       exercises: z4.array(
         z4.object({
           exerciseTemplateId: z4.string().min(1),
-          supersetId: z4.number().nullable().optional(),
+          supersetId: z4.coerce.number().nullable().optional(),
           notes: z4.string().optional().nullable(),
           sets: z4.array(
             z4.object({
               type: z4.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
-              weightKg: z4.number().optional().nullable(),
-              reps: z4.number().int().optional().nullable(),
-              distanceMeters: z4.number().int().optional().nullable(),
-              durationSeconds: z4.number().int().optional().nullable(),
-              rpe: z4.number().optional().nullable(),
-              customMetric: z4.number().optional().nullable()
+              weightKg: z4.coerce.number().optional().nullable(),
+              reps: z4.coerce.number().int().optional().nullable(),
+              distanceMeters: z4.coerce.number().int().optional().nullable(),
+              durationSeconds: z4.coerce.number().int().optional().nullable(),
+              rpe: z4.coerce.number().optional().nullable(),
+              customMetric: z4.coerce.number().optional().nullable()
             })
           )
         })
@@ -825,47 +897,13 @@ ${JSON.stringify(workout, null, 2)}`
               type: "text",
               text: `Error updating workout: ${error instanceof Error ? error.message : String(error)}`
             }
-          ]
+          ],
+          isError: true
         };
       }
     }
   );
 }
-function formatWorkout(workout) {
-  return {
-    id: workout.id,
-    date: workout.createdAt,
-    name: workout.title,
-    description: workout.description,
-    duration: calculateDuration(workout.startTime || "", workout.endTime || ""),
-    exercises: workout.exercises?.map((exercise) => {
-      return {
-        name: exercise.title,
-        notes: exercise.notes,
-        sets: exercise.sets?.map((set) => ({
-          type: set.type,
-          weight: set.weightKg,
-          reps: set.reps,
-          distance: set.distanceMeters,
-          duration: set.durationSeconds,
-          rpe: set.rpe,
-          customMetric: set.customMetric
-        }))
-      };
-    })
-  };
-}
-function calculateDuration(startTime, endTime) {
-  try {
-    if (!startTime || !endTime) return "Unknown duration";
-    const start = typeof startTime === "number" ? startTime : new Date(startTime).getTime();
-    const end = typeof endTime === "number" ? endTime : new Date(endTime).getTime();
-    const durationMinutes = Math.round((end - start) / 6e4);
-    return `${durationMinutes} minutes`;
-  } catch (error) {
-    return "Unknown duration";
-  }
-}
 
 // src/utils/hevyClient.ts
 import {
@@ -2086,17 +2124,22 @@ var HevyClientNavigationMetadata = {
 
 // src/utils/hevyClient.ts
 function createClient(apiKey2, baseUrl) {
-  const authProvider = new ApiKeyAuthenticationProvider(apiKey2, "api-key", ApiKeyLocation.Header);
+  const authProvider = new ApiKeyAuthenticationProvider(
+    apiKey2,
+    "api-key",
+    ApiKeyLocation.Header
+  );
   const adapter = new FetchRequestAdapter(authProvider);
   adapter.baseUrl = baseUrl;
   return createHevyClient(adapter);
 }
 
 // src/index.ts
+import Package from "paketo";
 var HEVY_API_BASEURL = "https://api.hevyapp.com";
 var server = new McpServer({
-  name: "hevy",
-  version: "1.0.5"
+  name: Package.name,
+  version: Package.version
 });
 if (!process.env.HEVY_API_KEY) {
   console.error("HEVY_API_KEY environment variable is not set");