JEFit MCP Server

Instructions

Implementation Reference

• server.py:82-119 (handler)

  Main handler function for list_workout_dates tool. Includes decorator for MCP registration, type hints serving as input schema, and core logic to filter workout dates using get_workout_history().

  @mcp.tool
  def list_workout_dates(start_date: str, end_date: str | None = None) -> list[str]:
      """
      List all workout dates within a date range.
      
      Args:
          start_date: Start date in YYYY-MM-DD format (required)
          end_date: End date in YYYY-MM-DD format (optional, defaults to today)
      
      Returns:
          List of workout dates as strings in YYYY-MM-DD format
      """
      # Default end_date to today if not provided
      if end_date is None:
          end_date = date.today().isoformat()
      
      # Validate date formats
      try:
          start = datetime.strptime(start_date, "%Y-%m-%d").date()
          end = datetime.strptime(end_date, "%Y-%m-%d").date()
      except ValueError as e:
          raise ValueError(f"Invalid date format. Use YYYY-MM-DD format: {e}")
      
      if start > end:
          raise ValueError("start_date must be before or equal to end_date")
      
      # Get all workout dates from API
      all_dates = get_workout_history()
      
      # Filter to date range
      filtered_dates = []
      for workout_date_str in all_dates:
          workout_date = datetime.strptime(workout_date_str, "%Y-%m-%d").date()
          if start <= workout_date <= end:
              filtered_dates.append(workout_date_str)
      
      return sorted(filtered_dates)

• history.py:8-29 (helper)

  Helper function that fetches all workout dates from the JEFit API, filtering for workouts with logs. Called by the list_workout_dates handler.

  def get_workout_history():
      access_token = get_access_token()
      user_id = get_user_id(access_token)
      timezone_offset = os.getenv("JEFIT_TIMEZONE", "-04:00")
  
      headers = {
          'content-type': 'application/json',
          'Cookie': f'jefitAccessToken={access_token}'
      }
      response = requests.get(f"https://www.jefit.com/api/v2/users/{user_id}/sessions/calendar?timezone_offset={timezone_offset}", headers=headers)
      if response.status_code != 200:
          raise Exception(f"Failed to get workout history: {response.status_code} {response.text}")
      else:
          calendar = response.json()
          calendar_data = calendar["data"]
          workouts = []
          for workout in calendar_data:
              # We will skip if the workout has no logs
              if not workout["has_logs"]:
                  continue
              workouts.append(workout["date"])
          return workouts