SensorBio MCP Server

A Model Context Protocol (MCP) server for the SensorBio wearable platform API (api.getsensr.io). Gives AI assistants access to real-time biometric, sleep, activity, and health score data from Sensr wearable devices.

Tools

Tool	Description
list_users	List all users in the organization
get_user_ids	Get all user IDs (lightweight)
get_biometrics	Paginated biometric readings (HR, HRV, SpO2, respiratory rate)
get_biometrics_timeseries	Continuous biometric timeseries for a metric (max 6h window)
get_activity_timeseries	Normalized activity intensity timeseries (max 6h window)
get_sleep	Sleep data: stages, durations, biometrics, score, disturbances, debt
get_sleep_trend	Aggregated sleep data (week/month/year)
get_activities	Workout data: exercises, reps, calories, duration, scores
get_calories	Calorie breakdown (resting, workout, active) with timeseries
get_scores	Daily health scores: sleep, recovery, activity
get_insights	AI-generated daily health insights
get_devices	Device info: type, battery, last sync
get_health_summary	All-in-one daily snapshot (scores + sleep + calories + device)
request_raw_download	Async raw data export (PPG, accel, gyro) as CSV/Parquet
get_job_status	Check raw data download job status

Setup

Prerequisites

• Node.js >= 18
• A Sensr Bio Organization API Key (from platform.getsensr.io > Developers)

Install

npm install
npm run build

Configure

Set the SENSR_API_KEY environment variable:

export SENSR_API_KEY="your-org-api-key-here"

Run

npm start

The server communicates over stdio using the MCP protocol.

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sensr-bio": {
      "command": "node",
      "args": ["/path/to/sensr-mcp-server/dist/index.js"],
      "env": {
        "SENSR_API_KEY": "your-org-api-key-here"
      }
    }
  }
}

Use with Claude Code

claude mcp add sensr-bio -- node /path/to/sensr-mcp-server/dist/index.js

API Coverage

This server wraps the Sensr Developers API v1.3.1, covering:

• Biometrics: Heart rate, HRV, SpO2, respiratory rate, IBI
• Sleep: Stages, scores, disturbances, sleep debt/accounting
• Activities: Workout detection, rep counting, exercise classification
• Calories: Resting, active, workout breakdown
• Scores: Sleep, recovery, activity (daily composite)
• Devices: Battery, sync status, device type
• Organization: User management, user listing
• Raw Data: Async PPG/accel/gyro export

Authentication

Uses Organization API Key authentication (Authorization: APIKey <key>). Generate one from platform.getsensr.io > Developers. All data endpoints require a user_id parameter to specify which user's data to access.

Note: The Sensr auth server does not support authorization_code grant for external OAuth2 apps. Org API Key is the only supported auth method for third-party integrations.

License

MIT