Renpho

Provides access to Renpho body composition data via MCP for querying weight, fat, and health metrics.

javascript

1

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a Renpho MCP Server locally to query body composition data from Renpho smart scales. This server lets you access weight, fat, muscle mass, hydration, and other health metrics through any MCP-compatible client by authenticating with your Renpho Health account.

How to use

Run the MCP server locally and connect your MCP client (Claude, Cursor, or any MCP-compatible tool) to retrieve your Renpho data. You will authenticate with your Renpho Health account, then you can ask the client for current measurements, weight trends, and historical data. Use the available endpoints to fetch the most recent reading, a full body composition report, or a time-based weight trend.

How to install

Prerequisites set up before installing: Node.js 18 or newer and a Renpho Health account with a connected smart scale. This setup uses the Renpho Health API, so you will authenticate with your Renpho account.

Install steps you will follow exactly:

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

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

Configuration and running the server

Configure your environment variables so the server can authenticate with Renpho and fetch data.

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

Additional setup for MCP clients

You can connect through MCP clients by providing a runtime command that starts the server with the required environment variables. The following examples show how to wire the server into your MCP client settings.

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

Security and privacy notes

Credentials are used only to authenticate with Renpho's API and are never logged. All communications are over HTTPS to protect your data.

Tokens are cached to reduce API calls and improve responsiveness, with sensible expiration and refresh handling.

Troubleshooting tips

If you encounter authentication issues, verify that your Renpho account email and password are correct and that your Renpho Health app is connected to the same account.

If the MCP client cannot reach the server, check that the node process is running and that environment variables are passed to the process correctly.

Available tools

get_latest_measurement

Fetches the most recent body composition reading for the connected user.

get_body_composition

Retrieves detailed body composition data including health classifications.

get_weight_trend

Provides weight change analysis over a specified number of days.

get_measurements

Returns historical measurements with optional date filtering.

get_current_user

Returns the current user profile information.

health_check

Verifies the API connection status and readiness of the MCP server.