JEFit MCP Server

MCP server for analyzing JEFit workout data. Provides tools to list workout dates and retrieve detailed workout information.

Setup

1. Install dependencies:

   uv sync

2. Configure environment variables:

   Set the following environment variables or use your secrets manager of choice.

   JEFIT_USERNAME=your_username JEFIT_PASSWORD=your_password JEFIT_TIMEZONE=-07:00

   Note: Use timezone offset format like -07:00 for PDT, -04:00 for EDT

The exercise database will be automatically fetched and cached on first startup.

MCP Configuration

Local/stdio Configuration (Recommended)

Add to your MCP client configuration:

Configuration Locations

• Cursor: .cursor/mcp.json (project) or ~/.cursor/mcp.json (user)

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

• VS Code: .vscode/mcp.json

Available Tools

1. list_workout_dates

List all workout dates within a date range.

Parameters:

• start_date (required): Start date in YYYY-MM-DD format

• end_date (optional): End date in YYYY-MM-DD format (defaults to today)

Returns: List of workout dates

Example:

2. get_workout_info

Get detailed workout information for a specific date.

Parameters:

• date (required): Date in YYYY-MM-DD format

Returns: Markdown-formatted workout details including:

• Start time and duration

• Total weight lifted

• Exercise list with muscle groups, equipment, sets, and reps

Example:

3. get_batch_workouts

Get detailed workout information for multiple dates in a single call.

Parameters:

• dates (required): List of dates in YYYY-MM-DD format

Returns: Markdown-formatted workout details for all requested dates, separated by horizontal rules

Example:

Testing

Run the test script to verify everything works:

Project Structure

Development

The server uses FastMCP 2.12+ and supports both stdio and HTTP transports. By default, it runs in stdio mode. To run in HTTP mode, set the HOST and PORT environment variables.