eufylife-mcp

An MCP (Model Context Protocol) server for EufyLife smart scale body composition data. Exposes your weight, BMI, body fat, muscle mass, and 20+ other measurements as tools that AI assistants can use.

Built by reverse-engineering the EufyLife cloud API, based on the work done by @m4ary in eufylife-api-hacs.

Features

• Authenticate with your EufyLife cloud account
• Retrieve latest and historical body composition measurements
• Multi-user support — list family member profiles sharing the same scale
• List connected devices and their configuration
• 20+ body composition measurements (weight, BMI, body fat, muscle mass, bone mass, BMR, body age, water percentage, protein ratio, visceral fat, and more)
• Auto-login via environment variables
• Token auto-refresh (tokens valid ~30 days)

Prerequisites

• Bun runtime (v1.0+)
• A EufyLife account with a connected smart scale

Installation

From npm (recommended)

bunx eufylife-mcp

From source

git clone https://github.com/MatthewHallCom/eufylife-mcp.git
cd eufylife-mcp
bun install
bun run src/index.ts

Configuration

Environment Variables

| Variable | Description | |---|---| | EUFYLIFE_EMAIL | Your EufyLife account email | | EUFYLIFE_PASSWORD | Your EufyLife account password |

When both are set, the server auto-authenticates on startup. Alternatively, use the login tool at runtime.

Claude Code

Add to your project's .mcp.json file:

{
  "mcpServers": {
    "eufylife": {
      "command": "bunx",
      "args": ["eufylife-mcp"],
      "env": {
        "EUFYLIFE_EMAIL": "[email protected]",
        "EUFYLIFE_PASSWORD": "your-password"
      }
    }
  }
}

Or add to .claude/settings.local.json:

{
  "mcpServers": {
    "eufylife": {
      "command": "bun",
      "args": ["run", "src/index.ts"],
      "cwd": "/path/to/eufylife-mcp",
      "env": {
        "EUFYLIFE_EMAIL": "[email protected]",
        "EUFYLIFE_PASSWORD": "your-password"
      }
    }
  }
}

Other MCP Clients

This server uses stdio transport and works with any MCP-compatible client. Point your client at:

bunx eufylife-mcp

Set EUFYLIFE_EMAIL and EUFYLIFE_PASSWORD as environment variables.

Available Tools

login

Authenticate with EufyLife cloud.

| Parameter | Type | Required | Description | |---|---|---|---| | email | string | yes | EufyLife account email | | password | string | yes | EufyLife account password |

Returns user ID, customer profiles, and connected devices.

get_measurements

Get the most recent body composition measurement for each user/family member.

| Parameter | Type | Required | Description | |---|---|---|---| | customer_id | string | no | Filter by specific customer/family member |

get_measurement_history

Get historical measurements since a given date.

| Parameter | Type | Required | Description | |---|---|---|---| | since | string | no | ISO 8601 date (e.g. 2024-01-01) | | customer_id | string | no | Filter by specific customer/family member |

Returns all measurements after the given date. Omit since to get full history.

list_users

List all customer/family member profiles associated with the account. Returns name, sex, height, birthday, target weight, and member type for each user. No parameters.

get_device_info

List all connected EufyLife devices with model info, product code, BLE MAC, weight unit setting, and room assignment. No parameters.

Available Resources

| URI | Description | |---|---| | eufylife://users | JSON list of customer/family member profiles | | eufylife://measurements/{customer_id} | Latest measurements for a specific customer |

Supported Measurements

All measurements from the EufyLife smart scale scale_data response:

| Measurement | Unit | Field | |---|---|---| | Weight | kg | weight_kg | | BMI | kg/m² | bmi | | Body Fat | % | body_fat_pct | | Subcutaneous Fat Rate | % | subcutaneous_fat_rate_pct | | Visceral Fat Index | index | visceral_fat_index | | Muscle | % | muscle_pct | | Muscle Mass | kg | muscle_mass_kg | | Skeletal Muscle Mass | kg | skeletal_muscle_mass_kg | | BMR (Basal Metabolic Rate) | kcal/day | bmr_kcal | | Bone | kg | bone_kg | | Bone Mass | kg | bone_mass_kg | | Water | % | water_pct | | Body Age | years | body_age_years | | Protein Ratio | % | protein_ratio_pct | | Visceral Fat | level | visceral_fat_level | | Fat Free Weight | kg | fat_free_weight_kg | | Body Fat Mass | kg | body_fat_mass_kg | | Heart Rate | bpm | heart_rate_bpm | | Body Type | type | body_type | | Height | cm | height_cm |

Not all scales report every measurement. Fields that are unavailable or zero from the API are returned as null.

Supported Devices

This server works with EufyLife smart scales that use the EufyLife cloud API, including:

| Model | Product Code | |---|---| | Smart Scale P1 | T9147 | | Smart Scale P2 Pro | T9149 | | Smart Scale P3 | T9150 | | Smart Scale C1 | T9146 | | Smart Scale A1 | T9960 | | Smart Scale | T9140 |

Other EufyLife/Anker smart scales that sync to the EufyLife app should also work.

Local Development

# Install dependencies
bun install

# Run the server
bun run src/index.ts

# Type check
bun x tsc --noEmit

# Explore the raw API (requires .env with credentials)
bun run scripts/explore-api.ts

How It Works

This server communicates with the undocumented EufyLife cloud API (api.eufylife.com) used by the official EufyLife iOS/Android app. The API interaction patterns were derived from the eufylife-api-hacs Home Assistant integration.

Key API endpoints:

• POST /v1/user/v2/email/login — authenticate and get user/device/customer data
• GET /v1/device/data — fetch scale measurements (supports ?after={timestamp} for incremental)
• GET /v1/customer/target/{id} — fetch per-customer target weight and goals

Limitations

• Unofficial API — Uses the undocumented EufyLife cloud API. It may break if EufyLife changes their API.
• Cloud-only — Requires internet access to fetch data from EufyLife servers. No local/BLE support.
• Read-only — This server only reads data. It cannot modify settings, delete measurements, or control devices.
• Token expiry — Tokens are valid for ~30 days. The server auto-refreshes when credentials are stored.

Credits

• eufylife-api-hacs by @m4ary — the Home Assistant integration that this project's API implementation is based on.
• Model Context Protocol — the protocol that enables AI assistants to use this server.

License

MIT