Skip to main content
Glama
fitdays-mcp-server

fitdays-mcp-server

by brad28820

fitdays-mcp-server

npm

Sponsor

Model Context Protocol server that exposes the unofficial FitDays / iComon smart-scale API as tools that an LLM client (Claude Desktop, Claude Code, etc.) can call.

It logs into your FitDays account once, caches a full ~6-year sync in memory, and serves the data as structured tool responses.

Tools

Tool

What it does

list_users

Sub-users (people) registered under the account.

list_devices

FitDays-compatible devices known to the account.

get_weight_history

Body-composition / weight measurements. Filters: suid, since, until, limit, include_deleted (default true — the FitDays mobile app marks edited records is_deleted: 1 rather than removing them server-side), include_ext_data (default false — adds the FitDays reference ranges, targets and body-type classification to each record).

get_latest_weight

Most recent weight measurement (filter by suid; include_deleted defaults to false; include_ext_data defaults to true).

refresh_sync

Force-refresh the cached sync data. Returns counts including the active / deleted / total split for weight records.

Related MCP server: Renpho Health MCP

Install

npm install -g fitdays-mcp-server

Requires Node.js ≥ 22.

Configuration

The server reads credentials from environment variables:

Variable

Required

Default

FITDAYS_EMAIL

yes

—

FITDAYS_PASSWORD

yes

—

FITDAYS_REGION

no

us (other values: see fitdays-api regions)

Use with Claude Desktop / Claude Code

Add it to your MCP client config (claude_desktop_config.json or ~/.claude.json / .mcp.json):

{
  "mcpServers": {
    "fitdays": {
      "command": "npx",
      "args": ["-y", "fitdays-mcp-server"],
      "env": {
        "FITDAYS_EMAIL": "you@example.com",
        "FITDAYS_PASSWORD": "your-password"
      }
    }
  }
}

Run with Docker

A multi-arch image (linux/amd64, linux/arm64) is published to GitHub Container Registry on every release, tagged with the release version (1.2.0, 1.2, 1) and latest:

docker run -d --name fitdays-mcp \
  -e FITDAYS_EMAIL=you@example.com \
  -e FITDAYS_PASSWORD=your-password \
  -p 8000:8000 \
  ghcr.io/roquerodrigo/fitdays-mcp-server:latest

The container serves the server over Streamable HTTP at http://localhost:8000/mcp, with a health endpoint at /healthz, so remote MCP clients can connect to it directly:

{
  "mcpServers": {
    "fitdays": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Credentials are read only from the environment; nothing is baked into the image. To use the stdio transport instead, run the server binary as the container command:

{
  "mcpServers": {
    "fitdays": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "FITDAYS_EMAIL", "-e", "FITDAYS_PASSWORD",
        "ghcr.io/roquerodrigo/fitdays-mcp-server:latest",
        "fitdays-mcp-server"
      ],
      "env": {
        "FITDAYS_EMAIL": "you@example.com",
        "FITDAYS_PASSWORD": "your-password"
      }
    }
  }
}

Run from source

git clone https://github.com/roquerodrigo/fitdays-mcp-server.git
cd fitdays-mcp-server
npm install
npm run build
FITDAYS_EMAIL=… FITDAYS_PASSWORD=… npm start

Support

This MCP server is built and maintained on personal time, on hardware bought for the purpose. If it is useful to you, consider sponsoring the work — it keeps the devices, the testing and the releases coming.

License

MIT

Available Tools

6 tools
get_latest_weightLatest weightA

Return the most recent body-composition / weight measurement in the current global cache, optionally for a single sub-user (suid). Data is fetched lazily when no valid cache exists and stored in a global cache shared by all tools for 5 minutes; subsequent queries use that cached snapshot until it expires. Use refresh_sync if you are within the 5-minute cache window and fresher data is required. Returns exactly one measurement containing weight_kg, weight_lb, bmi, bfr_pct (body fat percentage), rom_pct (muscle percentage), rosm_pct (skeletal muscle percentage), vwc_pct (body water percentage), pp_pct (protein percentage), sfr_pct (subcutaneous fat percentage), uvi (visceral fat index), bm_kg (bone mass), bmr_kcal (basal metabolic rate), bodyage (body age), measured_at (ISO 8601 timestamp), measured_time (Unix-seconds timestamp), data_id, suid, uid, is_deleted, and ext_data, or null if no matching measurement exists. ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation. Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only). Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields. Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight). Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard. Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index). Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree. Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null. Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer. By default ignores tombstoned records (is_deleted: 1).

Inputs: suid, include_deleted, include_ext_data.

get_todays_weigh_insToday's weigh-insA

Fetch all body-composition / weight measurements for a single calendar day (defaults to today in America/Chicago or FITDAYS_TIMEZONE) in one call. Returns date, timezone, count, has_weigh_in (boolean), latest (the most recent weigh-in for that day with full ext_data, or null if none), and weigh_ins (all weigh-ins for that day ordered newest first). By default forces a fresh sync (refresh: true) and excludes deleted records (include_deleted: false) while including full ext_data (include_ext_data: true). ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation. Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only). Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields. Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight). Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard. Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index). Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree. Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null. Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer.

Inputs: date, suid, refresh, timezone, +2 more.

get_weight_historyWeight historyA

Return body-composition / weight measurements, optionally filtered by sub-user (suid) and time window. Data is fetched lazily when no valid cache exists and stored in a global cache shared by all tools for 5 minutes; subsequent queries use that cached snapshot until it expires. Use refresh_sync if you are within the 5-minute cache window and fresher data is required. Returns a list ordered newest first. Each measurement contains weight_kg, weight_lb, bmi, bfr_pct (body fat percentage), rom_pct (muscle percentage), rosm_pct (skeletal muscle percentage), vwc_pct (body water percentage), pp_pct (protein percentage), sfr_pct (subcutaneous fat percentage), uvi (visceral fat index), bm_kg (bone mass), bmr_kcal (basal metabolic rate), bodyage (body age), measured_at (ISO 8601 timestamp), measured_time (Unix-seconds timestamp), data_id, suid, uid, and is_deleted. Set include_ext_data: true to also return ext_data for each record. ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation. Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only). Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields. Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight). Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard. Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index). Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree. Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null. Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer. By default includes tombstoned records (is_deleted: 1); set include_deleted: false to hide them.

Inputs: suid, limit, since, until, +2 more.

list_devicesList FitDays devicesA

List the devices bound to the FitDays account. Returns device_id (FitDays device identifier), name, model, mac (MAC address), and firmware_ver (firmware version) for each device.

Inputs: no named parameters.

list_usersList FitDays usersA

List the sub-users (people) registered under the FitDays account. Each user has a unique and stable suid, used by other tools to query data for that user. Returns a list where each entry contains nickname, sex (male or female, biological sex), birthday, height_cm, target_weight_kg (user-set target weight), suid, and uid (account uid).

Inputs: no named parameters.

refresh_syncRefresh sync cacheA

Force-refresh the global FitDays cache shared by all tools. FitDays data is loaded lazily: the first tool call that needs synchronized account data fetches a fresh snapshot and stores it in the global cache for 5 minutes. Returns synchronized record counts for devices, users, height_records, and weight_records (active, deleted, total).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 6 tools

    Disambiguation4/5

    The tools are mostly clearly separated by purpose: users, devices, history, today's weigh-ins, latest measurement, and cache refresh. The three weight-retrieval tools overlap in data type, but their descriptions make the distinctions between filtered history, single-day convenience, and single latest record reasonably clear.

    Naming Consistency4/5

    Most names follow a consistent snake_case verb_noun pattern, such as list_users, get_weight_history, and refresh_sync. Minor deviations include get_todays_weigh_ins using 'weigh_ins' while other tools use 'weight', which is readable but slightly inconsistent.

    Tool Count5/5

    Six tools is well scoped for a read-only FitDays data server. Each tool covers a distinct access pattern or cache operation, and none feels redundant enough to remove.

    Completeness4/5

    The surface covers users, devices, weight history, daily weigh-ins, latest measurement, and cache refresh. A minor gap is that refresh_sync references height_records, but no tool exposes height-record history, so that part of the domain is not directly accessible.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query and analyze Renpho smart scale data (weight, body fat, etc.) by syncing it from the Renpho app and exposing it through MCP tools for conversational exploration.
      1
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      Exposes client health data through a consolidated tool surface covering sleep, exercise, nutrition, cardio, fitness, cognitive, lifestyle, trends, notes, and chat history. Enables LLMs to retrieve time-series vitals, periodic assessments, unstructured text, and rolled-up summaries via standardized envelopes.
      11
      -