Withings Health

Step 2: Create Your Application

1. Navigate to My Apps → Create an Application
2. Fill in the application details:
   • Application Name: Choose a name (e.g., "My Clawdbot Health")
   • Description: Brief description of your use case
   • Contact Email: Your email address
   • Callback URL: http://localhost:8080 (required for OAuth)
   • Application Type: Select "Personal Use" or appropriate type
3. Submit the application

Step 3: Get Your Credentials

Once your application is created:

1. Go to My Apps and select your application
2. You'll find:
   • Client ID → Set as WITHINGS_CLIENT_ID environment variable
   • Client Secret → Set as WITHINGS_CLIENT_SECRET environment variable

Step 4: Configure Environment Variables

Add these to your Clawdbot environment:

export WITHINGS_CLIENT_ID="your_client_id_here"
export WITHINGS_CLIENT_SECRET="your_client_secret_here"

Or create a .env file in the skill directory (this file will be ignored by git):

WITHINGS_CLIENT_ID=your_client_id_here
WITHINGS_CLIENT_SECRET=your_client_secret_here

Configuration

The skill uses a wrapper.js script located in {baseDir}.

Before any data retrieval, check if the user is authenticated. If an error mentions "No token found", guide the user through the initial authentication process.

Available Commands

1. Authentication

First-time setup - generates the OAuth URL:

node {baseDir}/wrapper.js auth

After the user visits the URL and gets the authorization code:

node {baseDir}/wrapper.js auth YOUR_CODE_HERE

2. Get Weight

Retrieve the latest weight measurements:

node {baseDir}/wrapper.js weight

Returns the 5 most recent weight entries in JSON format.

Example output:

[
  { "date": "2026-01-17T08:30:00.000Z", "weight": "75.40 kg" },
  { "date": "2026-01-16T08:15:00.000Z", "weight": "75.65 kg" }
]

3. Get Body Composition

Retrieve comprehensive body metrics (fat, muscle, bone, water, BMI):

node {baseDir}/wrapper.js body

Returns the 5 most recent body composition measurements.

Example output:

[
  {
    "date": "2026-01-17T08:30:00.000Z",
    "weight": "75.40 kg",
    "fat_percent": "18.5%",
    "fat_mass": "13.95 kg",
    "muscle_mass": "35.20 kg",
    "bone_mass": "3.10 kg",
    "hydration": "55.2%"
  }
]

4. Get Activity

Retrieve daily activity data (steps, distance, calories):

node {baseDir}/wrapper.js activity

Optionally specify the number of days (default: 7):

node {baseDir}/wrapper.js activity 30

Example output:

[
  {
    "date": "2026-01-17",
    "steps": 8542,
    "distance": "6.23 km",
    "calories": 2150,
    "active_calories": 450,
    "soft_activity": "45 min",
    "moderate_activity": "22 min",
    "intense_activity": "8 min"
  }
]

5. Get Sleep

Retrieve sleep data and quality:

node {baseDir}/wrapper.js sleep

Optionally specify the number of days (default: 7):

node {baseDir}/wrapper.js sleep 14

Example output:

[
  {
    "date": "2026-01-17",
    "start": "23:15",
    "end": "07:30",
    "duration": "8h 15min",
    "deep_sleep": "1h 45min",
    "light_sleep": "4h 30min",
    "rem_sleep": "1h 30min",
    "awake": "30min",
    "sleep_score": 82
  }
]

Error Handling

Common errors and how to resolve them:

Notes

• Tokens are automatically refreshed when they expire
• Withings API scopes used: user.metrics, user.activity
• Data availability depends on which Withings devices the user owns
• Some metrics (like body composition) require a compatible smart scale37:["$","$L3f",null,{"content":"$40","frontMatter":{"name":"withings-health","description":"Fetches health data from the Withings API including weight, body composition (fat, muscle, bone, water), activity, and sleep. Use this skill when the user asks about their Withings data, weight history, body metrics, daily steps, sleep quality, or any health measurement from Withings devices.","version":"1.1.0","homepage":"https://developer.withings.com/","metadata":{"clawdbot":{"emoji":"⚖️","requires":{"bins":["node"],"env":["WITHINGS_CLIENT_ID","WITHINGS_CLIENT_SECRET"]}}}}}]