Renpho MCP Server

A Model Context Protocol (MCP) server that provides access to body composition data from Renpho smart scales. Query your weight, body fat, muscle mass, and other health metrics directly from Claude, Cursor, or any MCP-compatible client.

Features

• Body Composition Data: Weight, BMI, body fat %, muscle mass, water %, bone mass, visceral fat, metabolic age, BMR, and more
• Weight Trends: Track changes over customizable time periods (7-365 days)
• Health Classifications: Automatic BMI, body fat, and visceral fat category assessments
• Measurement History: Access historical measurements with date filtering
• MorphoScan history integration: Combines classic and eight-electrode records, retaining numerical advanced metrics under their API field names and merging complementary metadata only for confirmed duplicates
• Multi-table discovery: Scans all linked Renpho scale tables instead of assuming the first discovered scale-user ID is always correct
• Sync diagnostics: Inspect linked scale-user IDs, hidden measurements, and likely delayed Wi-Fi sync situations
• Secure: Credentials stored as environment variables, never logged

Requirements

• Node.js 18+
• A Renpho Health account with connected smart scale
• Important: This works with the Renpho Health app (blue icon), not the legacy Renpho app

Installation

Releases are distributed as source code on GitHub, not as an npm package. Install dependencies and build locally. For a pinned release, add --branch v1.2.1 to the clone command below; omit it to use the latest main. See CHANGELOG.md for changes and compatibility limits.

git clone https://github.com/StartupBros-com/renpho-mcp-server.git
cd renpho-mcp-server
npm install
npm run build

Configuration

Create a .env file (or set environment variables):

[email protected]
RENPHO_PASSWORD=your-password

Claude Code

Add the server to ~/.claude.json for user-wide configuration, or .mcp.json in your client project’s root for project-scoped configuration—not settings.json. See Claude Code’s MCP documentation.

The example below reads credentials from the environment that launches Claude Code. Set RENPHO_EMAIL and RENPHO_PASSWORD there; do not commit real credentials in a project-scoped .mcp.json.

{
  "mcpServers": {
    "renpho": {
      "command": "node",
      "args": ["/path/to/renpho-mcp-server/dist/index.js"],
      "env": {
        "RENPHO_EMAIL": "${RENPHO_EMAIL}",
        "RENPHO_PASSWORD": "${RENPHO_PASSWORD}"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "renpho": {
      "command": "node",
      "args": ["/path/to/renpho-mcp-server/dist/index.js"],