get_heart_rate
Retrieve heart rate measurements from Withings devices within a specified time period to monitor cardiovascular health trends.
Instructions
Get heart rate measurements over a time period
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| startdate | No | Start date (YYYY-MM-DD) or Unix timestamp | |
| enddate | No | End date (YYYY-MM-DD) or Unix timestamp |
Implementation Reference
- The handler function _get_heart_rate that constructs API parameters and calls the Withings measure endpoint with 'getintradayactivity' action to retrieve heart rate measurements.async def _get_heart_rate(self, args: dict) -> dict: """Get heart rate data.""" params = {"action": "getintradayactivity"} if "startdate" in args: params["startdate"] = self._parse_date(args["startdate"]) if "enddate" in args: params["enddate"] = self._parse_date(args["enddate"]) return await self._make_request("/v2/measure", params)
- Input schema defining the parameters for the get_heart_rate tool: optional startdate and enddate as strings.inputSchema={ "type": "object", "properties": { "startdate": { "type": "string", "description": "Start date (YYYY-MM-DD) or Unix timestamp", }, "enddate": { "type": "string", "description": "End date (YYYY-MM-DD) or Unix timestamp", }, }, },
- src/withings_mcp_server/server.py:147-163 (registration)Tool registration in list_tools() decorator, specifying name, description, and input schema for get_heart_rate.Tool( name="get_heart_rate", description="Get heart rate measurements over a time period", inputSchema={ "type": "object", "properties": { "startdate": { "type": "string", "description": "Start date (YYYY-MM-DD) or Unix timestamp", }, "enddate": { "type": "string", "description": "End date (YYYY-MM-DD) or Unix timestamp", }, }, }, ),