JEFit MCP Server

Instructions

Implementation Reference

• server.py:121-184 (handler)

  Handler function for the 'get_workout_info' tool. It validates the date input, fetches raw workout data using the helper function, enriches it with exercise details from a preloaded database, formats the output as structured Markdown, and returns it as a ToolResult. The @mcp.tool decorator handles registration.

  @mcp.tool
  def get_workout_info(date: str) -> ToolResult:
      """
      Get detailed workout information for a specific date.
      
      Args:
          date: Date in YYYY-MM-DD format
      
      Returns:
          Markdown-formatted workout details including exercises, sets, reps, and weights
      """
      # Validate date format
      try:
          datetime.strptime(date, "%Y-%m-%d")
      except ValueError as e:
          raise ValueError(f"Invalid date format. Use YYYY-MM-DD format: {e}")
      
      # Get workout data from API
      workout_data = get_workout_for_date(date)
      
      # Build markdown output
      output_lines = []
      output_lines.append(f"# Workout for {date}\n")
      
      if 'data' not in workout_data or not workout_data['data']:
          output_lines.append("No workout found for this date.")
          markdown_text = "\n".join(output_lines)
          return ToolResult(content=[TextContent(type="text", text=markdown_text)])
      
      for session in workout_data['data']:
          session_date = datetime.fromtimestamp(session['date']).strftime('%Y-%m-%d %H:%M:%S')
          duration_minutes = session['total_time'] // 60
          duration_seconds = session['total_time'] % 60
          total_weight = session['total_weight']
          
          output_lines.append(f"**Started:** {session_date}")
          output_lines.append(f"**Duration:** {duration_minutes}m {duration_seconds}s")
          output_lines.append(f"**Weight Lifted:** {total_weight} lbs\n")
          
          output_lines.append("## Exercises\n")
          
          for i, log in enumerate(session['logs'], 1):
              exercise_id = log['exercise_id']
              exercise = EXERCISE_DB.get(exercise_id, {})
              
              name = exercise.get('name', f'Unknown Exercise ({exercise_id})')
              muscle_groups = ', '.join(exercise.get('body_parts', ['Unknown']))
              equipment = ', '.join(exercise.get('equipment', ['Unknown']))
              
              output_lines.append(f"### {i}. {name}")
              output_lines.append(f"- **Muscle Groups:** {muscle_groups}")
              output_lines.append(f"- **Equipment:** {equipment}")
              output_lines.append("")
              
              # Add sets information
              for j, s in enumerate(log['log_sets'], 1):
                  weight = s.get('weight', 0)
                  reps = s.get('reps', 0)
                  output_lines.append(f"  - Set {j}: {weight} lbs × {reps} reps")
              
              output_lines.append("")  # Blank line between exercises
      
      markdown_text = "\n".join(output_lines)
      return ToolResult(content=[TextContent(type="text", text=markdown_text)])

• workout_info.py:97-111 (helper)

  Core helper function that makes the API request to JEFit to retrieve raw workout session data for a specific date. Converts date to Unix timestamp and uses authenticated headers.

  def get_workout_for_date(date_str):
      """Get workout logs for a specific date"""
      date_unix = int(time.mktime(time.strptime(date_str, "%Y-%m-%d")))
      # Get Access Token and User ID
      access_token = get_access_token()
      user_id = get_user_id(access_token)
      url = f"https://www.jefit.com/api/v2/users/{user_id}/sessions?startDate={date_unix}"
      headers = {
          'content-type': 'application/json',
          'Cookie': f'jefitAccessToken={access_token}'
      }
      
      response = requests.get(url, headers=headers)
      return response.json()

• workout_info.py:61-96 (helper)

  Helper function that loads or fetches and caches the JEFit exercise database (names, muscle groups, equipment) used to enrich workout logs with human-readable exercise information.

  def load_exercise_db():
      """Load exercise database from JSON cache, creating it if necessary"""
      db_path = Path('data/exercises_db.json')
      
      # Create data directory if it doesn't exist
      db_path.parent.mkdir(exist_ok=True)
      
      # If database doesn't exist, fetch and create it
      if not db_path.exists():
          print("Exercise database not found. Fetching from JEFit...")
          try:
              exercises = fetch_exercise_database()
              
              if not exercises:
                  print("⚠️  No exercises found. Check your authentication.")
                  return {}
              
              # Save to JSON
              with open(db_path, 'w') as f:
                  json.dump(exercises, f, indent=2)
              
              print(f"✓ Created exercise database with {len(exercises)} exercises")
              return exercises
              
          except Exception as e:
              print(f"⚠️  Failed to fetch exercise database: {e}")
              return {}
      
      # Load existing database
      try:
          with open(db_path, 'r') as f:
              return json.load(f)
      except Exception as e:
          print(f"⚠️  Error loading exercise database: {e}")
          return {}