home / mcp / jefit mcp server

JEFIT MCP Server

An MCP Server for the JEFit Workout Tracking App / API

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ai-mcp-garage-jefit-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/jefit-mcp",
        "python",
        "server.py"
      ],
      "env": {
        "JEFIT_PASSWORD": "YOUR_PASSWORD",
        "JEFIT_TIMEZONE": "-07:00",
        "JEFIT_USERNAME": "YOUR_USERNAME"
      }
    }
  }
}

This MCP server analyzes JEFit workout data and exposes practical actions you can perform from your MCP client, such as listing workout dates and retrieving detailed workout information. It fetches the exercise database once on startup and then serves fast, structured results for your fitness analysis workflows.

How to use

You interact with the JEFit MCP Server through your MCP client to query workout history and details. Use the available actions to gather dates for workouts within a range, fetch full workout details for a single date, or retrieve details for multiple dates in one call. Each result is returned in a structured, readable format that you can review or export for analysis.

How to install

Prerequisites - Ensure you have the MCP runtime available on your system. The server expects to be run via the standard MCP stdio flow using the uv tool.

Step 1: Install dependencies - Run the dependency synchronization command.

uv sync

Step 2: Configure environment variables Set these variables in your environment or your secrets manager of choice. Replace the placeholders with your actual credentials and preferred timezone offset.

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

Note: Use a timezone offset format like -07:00 for PDT or -04:00 for EDT. The exercise database will be fetched and cached automatically on first startup.

MCP configuration

Local/stdio configuration (recommended) is used to run the server locally and connect via a standard MCP client. The runtime command executes the Python server from its directory.

{
  "mcpServers": {
    "jefit_workouts": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/jefit-mcp", "python", "server.py"]
    }
  }
}

Configuration locations for storing MCP settings vary by tool. Typical locations include project/ user configuration paths shown in your MCP client’s setup.

Testing

Verify the server runs correctly by executing the test script. This helps ensure the server can start, fetch data, and respond to tool requests as expected.

uv run python scripts/test_server.py

Available tools

list_workout_dates

Returns all workout dates within a specified date range, enabling you to quickly identify days with workouts.

get_workout_info

Retrieves detailed information for a single workout date, including start time, duration, total weight lifted, and a breakdown of exercises with muscle groups, equipment, sets, and reps.

get_batch_workouts

Fetches detailed workout information for multiple dates in one call, returning the results separated by clear divisions.