inbody-api-mcp — Claude Code MCP server: what it does, how to install
Reads InBody profile and scan data through MCP, including body fat, muscle mass and water. Use it when an agent needs access to your measurements.
claude mcp add --env INBODY_LOGIN_ID=<INBODY_LOGIN_ID> --env INBODY_LOGIN_PW=<INBODY_LOGIN_PW> --env INBODY_COUNTRY_CODE=<INBODY_COUNTRY_CODE> --transport stdio inbody-api-mcp -- uvx inbody-api-mcpWhat inbody-api-mcp does
inbody-api-mcp connects to the REST service used by the InBody mobile app and exposes body-composition records to MCP clients. Its tools return the user profile, scan count, chronological scan summaries and the full metrics for one scan, including water, fat, BMI, muscle data and segmental impedance.
The server signs in with the registration phone number, password and country code. It resolves the regional API host and renews authentication after the JWT expires. Install uv first; the process is started on demand with uvx and communicates through stdio only.
This is a read-only connection: it has no write or delete operations. The login ID must be the registration phone number as digits only, without a country prefix or +; an email address will fail authentication.
What it helps with
- read an InBody profile from an agent
- inspect a chronological scan history
- retrieve the full metrics for one scan
- review body fat, BMI and muscle measurements
Example prompts for the agent
- Use
get_profileto show my InBody profile and baseline measurements. - List my recent InBody scans with weight, BMI, body-fat percentage and muscle mass.
- Retrieve the full details for the selected scan, including water and impedance data.
How to install inbody-api-mcp
Platform CLI
claude mcp add --env INBODY_LOGIN_ID=<INBODY_LOGIN_ID> --env INBODY_LOGIN_PW=<INBODY_LOGIN_PW> --env INBODY_COUNTRY_CODE=<INBODY_COUNTRY_CODE> --transport stdio inbody-api-mcp -- uvx inbody-api-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from inbody-api-mcp <command>
Platform CLI
codex mcp add inbody-api-mcp --env INBODY_LOGIN_ID=<INBODY_LOGIN_ID> --env INBODY_LOGIN_PW=<INBODY_LOGIN_PW> --env INBODY_COUNTRY_CODE=<INBODY_COUNTRY_CODE> -- uvx inbody-api-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from inbody-api-mcp <command>
Config file
{
"mcpServers": {
"inbody-api-mcp": {
"command": "uvx",
"args": [
"inbody-api-mcp"
],
"env": {
"INBODY_LOGIN_ID": "<INBODY_LOGIN_ID>",
"INBODY_LOGIN_PW": "<INBODY_LOGIN_PW>",
"INBODY_COUNTRY_CODE": "<INBODY_COUNTRY_CODE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from inbody-api-mcp <command>
Config file
{
"servers": {
"inbody-api-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"inbody-api-mcp"
],
"env": {
"INBODY_LOGIN_ID": "<INBODY_LOGIN_ID>",
"INBODY_LOGIN_PW": "<INBODY_LOGIN_PW>",
"INBODY_COUNTRY_CODE": "<INBODY_COUNTRY_CODE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from inbody-api-mcp <command>
Platform CLI
gemini mcp add -e INBODY_LOGIN_ID=<INBODY_LOGIN_ID> -e INBODY_LOGIN_PW=<INBODY_LOGIN_PW> -e INBODY_COUNTRY_CODE=<INBODY_COUNTRY_CODE> inbody-api-mcp uvx inbody-api-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from inbody-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about inbody-api-mcp
How do I install inbody-api-mcp in Claude Code?
Run claude mcp add inbody-api-mcp -e INBODY_LOGIN_ID=<INBODY_LOGIN_ID> -e INBODY_LOGIN_PW=<INBODY_LOGIN_PW> -- uvx inbody-api-mcp.
What does inbody-api-mcp do?
It gives an MCP client read access to an InBody profile, scan totals, scan history and detailed metrics for a selected scan. No write or delete tools are exposed.
Which credentials does inbody-api-mcp require?
Use the phone number supplied during InBody registration and the account password. INBODY_LOGIN_ID accepts digits only, with no country prefix or +; an email cannot be used to sign in.
