Bluetooth LE Health Sensors — Claude Code MCP server: what it does
Bluetooth LE Health Sensors — an MCP server that reads health metrics from Bluetooth LE sensors: heart rate, SpO2, blood pressure, temperature, weight.
Apache-2.0 ★ 32 updated 2026-09-26
claude mcp add --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> --transport stdio ble-health-sensors -- uvx labmcp-ble-healthWhat Bluetooth LE Health Sensors does
The server connects to sensors implementing standard Bluetooth SIG profiles: heart-rate chest straps and armbands (Heart Rate Service 0x180D), pulse oximeters (0x1822), BP monitors (0x1810), thermometers (0x1809), and scales (0x181D). The agent retrieves heart rate with RR intervals for HRV analysis, oxygen saturation, blood pressure, temperature, and body weight through tools like record_heart_rate, read_pulse_oximetry, and read_weight.
The server runs on Linux, macOS, and Windows using the bleak library. Most smartwatches and fitness bands use vendor-specific protocols and will not work; chest straps broadcasting Heart Rate Service are the most dependable choice. On macOS, the terminal or MCP client must have Bluetooth permission in System Settings: without it, the process exits with code 134 before printing an error.
Before connecting, identify the sensor's MAC address on Linux or Windows (e.g., AA:BB:CC:DD:EE:FF) or CoreBluetooth UUID on macOS by running uvx labmcp-ble-health --check with the sensor active. To test without hardware, run uvx labmcp-ble-health --simulate --check: the simulator provides six devices with addresses 00:00:5E:00:53:01 through 06.
What it helps with
- capture heart-rate series with RR intervals and HRV metrics
- retrieve SpO2 and BP readings from an agent without manual export
- collect data from multiple sensors in one session
- check battery level and model of a connected device
Example prompts for the agent
- Record heart rate for 60 seconds and show mean HR with RR intervals
- Read SpO2 from the pulse oximeter and display the value
- Connect to the scale at
AA:BB:CC:DD:EE:FFand get body weight
How to install Bluetooth LE Health Sensors
Platform CLI
claude mcp add --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> --transport stdio ble-health-sensors -- uvx labmcp-ble-healthReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from labmcp-ble-health <command>
Platform CLI
codex mcp add ble-health-sensors --env LABMCP_ADDRESS=<LABMCP_ADDRESS> --env LABMCP_SIMULATE=<LABMCP_SIMULATE> --env LABMCP_READ_ONLY=<LABMCP_READ_ONLY> --env LABMCP_LIMITS=<LABMCP_LIMITS> -- uvx labmcp-ble-healthReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from labmcp-ble-health <command>
Config file
{
"mcpServers": {
"ble-health-sensors": {
"command": "uvx",
"args": [
"labmcp-ble-health"
],
"env": {
"LABMCP_ADDRESS": "<LABMCP_ADDRESS>",
"LABMCP_SIMULATE": "<LABMCP_SIMULATE>",
"LABMCP_READ_ONLY": "<LABMCP_READ_ONLY>",
"LABMCP_LIMITS": "<LABMCP_LIMITS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from labmcp-ble-health <command>
Config file
{
"servers": {
"ble-health-sensors": {
"type": "stdio",
"command": "uvx",
"args": [
"labmcp-ble-health"
],
"env": {
"LABMCP_ADDRESS": "<LABMCP_ADDRESS>",
"LABMCP_SIMULATE": "<LABMCP_SIMULATE>",
"LABMCP_READ_ONLY": "<LABMCP_READ_ONLY>",
"LABMCP_LIMITS": "<LABMCP_LIMITS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from labmcp-ble-health <command>
Platform CLI
gemini mcp add -e LABMCP_ADDRESS=<LABMCP_ADDRESS> -e LABMCP_SIMULATE=<LABMCP_SIMULATE> -e LABMCP_READ_ONLY=<LABMCP_READ_ONLY> -e LABMCP_LIMITS=<LABMCP_LIMITS> ble-health-sensors uvx labmcp-ble-healthReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from labmcp-ble-health <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 Bluetooth LE Health Sensors
How to install Bluetooth LE Health Sensors in Claude Code?
Run claude mcp add labmcp-ble-health -- uvx labmcp-ble-health in your terminal, then specify the sensor address via the LABMCP_ADDRESS environment variable or --address parameter when adding the server.
What does Bluetooth LE Health Sensors do?
The server connects to Bluetooth LE health sensors (heart-rate monitors, BP cuffs, thermometers, scales) and exposes their readings to the agent through MCP tools.
Which sensors does the server support?
Only devices with standard Bluetooth SIG profiles: Heart Rate Service, Pulse Oximeter, Blood Pressure, Health Thermometer, Weight Scale. Most smartwatches and fitness bands rely on proprietary protocols and are not compatible.