Hevy MCP

Instructions

Implementation Reference

• src/tools/folders.ts:69-85 (handler)

  Handler function that fetches the routine folder by ID using hevyClient.getRoutineFolder, checks if data exists, formats it with formatRoutineFolder, and returns a JSON response or empty response if not found.

  withErrorHandling(async ({ folderId }: { folderId: string }) => {
  	if (!hevyClient) {
  		throw new Error(
  			"API client not initialized. Please provide HEVY_API_KEY.",
  		);
  	}
  	const data = await hevyClient.getRoutineFolder(folderId);
  
  	if (!data) {
  		return createEmptyResponse(
  			`Routine folder with ID ${folderId} not found`,
  		);
  	}
  
  	const folder = formatRoutineFolder(data);
  	return createJsonResponse(folder);
  }, "get-routine-folder"),

• src/tools/folders.ts:66-68 (schema)

  Zod input schema for the tool: requires a 'folderId' string parameter.

  {
  	folderId: z.string().min(1),
  },

• src/tools/folders.ts:63-86 (registration)

  Registers the 'get-routine-folder' MCP tool with server.tool, including name, description, input schema, and wrapped handler.

  server.tool(
  	"get-routine-folder",
  	"Get complete details of a specific routine folder by its ID, including name, creation date, and associated routines.",
  	{
  		folderId: z.string().min(1),
  	},
  	withErrorHandling(async ({ folderId }: { folderId: string }) => {
  		if (!hevyClient) {
  			throw new Error(
  				"API client not initialized. Please provide HEVY_API_KEY.",
  			);
  		}
  		const data = await hevyClient.getRoutineFolder(folderId);
  
  		if (!data) {
  			return createEmptyResponse(
  				`Routine folder with ID ${folderId} not found`,
  			);
  		}
  
  		const folder = formatRoutineFolder(data);
  		return createJsonResponse(folder);
  	}, "get-routine-folder"),
  );