get_activity
Retrieve daily activity metrics including steps, calories burned, distance traveled, and elevation from Withings health data. Specify date ranges to track physical activity progress over time.
Instructions
Get daily activity data (steps, calories, distance, elevation)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| startdateymd | No | Start date in YYYY-MM-DD format | |
| enddateymd | No | End date in YYYY-MM-DD format | |
| lastupdate | No | Get activities modified since this timestamp |
Implementation Reference
- The main handler function for the 'get_activity' tool. It prepares the request parameters (action='getactivity', optional startdateymd, enddateymd, lastupdate) and calls the Withings API endpoint /v2/measure.async def _get_activity(self, args: dict) -> dict: """Get activity data.""" params = {"action": "getactivity"} if "startdateymd" in args: params["startdateymd"] = args["startdateymd"] if "enddateymd" in args: params["enddateymd"] = args["enddateymd"] if "lastupdate" in args: params["lastupdate"] = self._parse_date(args["lastupdate"]) return await self._make_request("/v2/measure", params)
- Input schema for the 'get_activity' tool, defining the expected parameters: startdateymd, enddateymd, and lastupdate.inputSchema={ "type": "object", "properties": { "startdateymd": { "type": "string", "description": "Start date in YYYY-MM-DD format", }, "enddateymd": { "type": "string", "description": "End date in YYYY-MM-DD format", }, "lastupdate": { "type": "string", "description": "Get activities modified since this timestamp", }, }, },
- src/withings_mcp_server/server.py:78-98 (registration)Registration of the 'get_activity' tool in the list_tools() function, including name, description, and input schema.Tool( name="get_activity", description="Get daily activity data (steps, calories, distance, elevation)", inputSchema={ "type": "object", "properties": { "startdateymd": { "type": "string", "description": "Start date in YYYY-MM-DD format", }, "enddateymd": { "type": "string", "description": "End date in YYYY-MM-DD format", }, "lastupdate": { "type": "string", "description": "Get activities modified since this timestamp", }, }, }, ),
- src/withings_mcp_server/server.py:212-213 (registration)Dispatch logic in the call_tool handler that routes 'get_activity' calls to the _get_activity method.elif name == "get_activity": result = await self._get_activity(arguments)