Renpho MCP Server

🚀 Renpho MCP Server

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

🚀 Quick Start

The Renpho MCP Server allows users to access body composition data from Renpho smart scales via MCP-compatible clients. Follow the installation and configuration steps below to get started.

✨ 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 data with filtering options.
• Secure: Credentials are stored as environment variables and never logged.

📦 Installation

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

📚 Documentation

Configuration

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

RENPHO_EMAIL=your-email@example.com
RENPHO_PASSWORD=your-password

Claude Code

Add to your MCP settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "renpho": {
      "command": "node",
      "args": ["/path/to/renpho-mcp-server/dist/index.js"],
      "env": {
        "RENPHO_EMAIL": "your-email@example.com",
        "RENPHO_PASSWORD": "your-password"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "renpho": {
      "command": "node",
      "args": ["/path/to/renpho-mcp-server/dist/index.js"],
      "env": {
        "RENPHO_EMAIL": "your-email@example.com",
        "RENPHO_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools

Example Usage

Once configured, you can ask Claude:

• "What's my current weight and body composition?"
• "Show my weight trend over the last 90 days"
• "How has my body fat percentage changed this year?"
• "Get my last 10 measurements"

🔧 Technical Details

• Uses the Renpho Health API (cloud.renpho.com), not the legacy API.
• Implements AES - 128 - ECB encryption for API communication.
• Handles JavaScript BigInt precision for large user IDs.
• Caches authentication tokens (50 min) and measurements (5 min) to reduce API calls.

💡 Usage Tip

• Important: This works with the Renpho Health app (blue icon), not the legacy Renpho app.
• The server has specific requirements: Node.js 18+ and a Renpho Health account with a connected smart scale.

📄 License

This project is licensed under the MIT license.

Credits

API reverse engineering is based on RenphoGarminSync-CLI by forkerer.