# Bluetooth LE Health Sensors

Bluetooth LE Health Sensors — an MCP server that reads health metrics from Bluetooth LE sensors: heart rate, SpO2, blood pressure, temperature, weight.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 32 repo stars
- Author: K-Dense-AI
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/K-Dense-AI/lab-instrument-mcps/tree/HEAD/servers/health/ble-health-sensors
- Updated: 2026-09-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bluetooth-le-health-sensors

## What it 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`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `LABMCP_ADDRESS`, `LABMCP_SIMULATE`, `LABMCP_READ_ONLY`, `LABMCP_LIMITS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-health
```
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>

### Codex

**Platform CLI**
```bash
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-health
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
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-health
```
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>

## When to use it
- 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
- 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:FF` and get body weight

## Similar
- [core-bluetooth](https://affpapa.org/en/nevibecode/skills/core-bluetooth.md) — skill · 4000 installs
- [c-bluetooth](https://affpapa.org/en/nevibecode/skills/c-bluetooth.md) — skill · ★ 179 repo stars
- [ble-mcp-server](https://affpapa.org/en/nevibecode/mcp/ble-mcp-server.md) — MCP server · ★ 20 repo stars
- [BLEA](https://affpapa.org/en/nevibecode/mcp/blea.md) — MCP server · ★ 13 repo stars
- [Health by Dr Brad](https://affpapa.org/en/nevibecode/mcp/health-by-dr-brad.md) — MCP server · ★ 11 repo stars
- [health](https://affpapa.org/en/nevibecode/skills/health.md) — skill · 16500 installs

From the same set: [k-dense-ai/lab-instrument-mcps](https://affpapa.org/en/nevibecode/by/k-dense-ai/lab-instrument-mcps.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
