@souravpn/whoop-mcp 1.0.0

package/README.md

@@ -0,0 +1,196 @@
+# whoop-mcp
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives Claude access to your WHOOP biometric data — recovery, sleep, strain, and workouts.
+
+Ask Claude things like:
+
+- _"How's my recovery today?"_
+- _"How did I sleep last night?"_
+- _"How has my HRV trended this week?"_
+- _"What was my strain from yesterday's workout?"_
+
+---
+
+## Privacy
+
+This app accesses your WHOOP data locally on your device. No data is sent to any third-party server.
+
+---
+
+## Tools
+
+| Tool                  | What it returns                                                       |
+| --------------------- | --------------------------------------------------------------------- |
+| `get_recovery`        | Recovery score, HRV, resting HR, SpO2                                 |
+| `get_sleep`           | Sleep duration, stages (light/deep/REM), efficiency, respiratory rate |
+| `get_strain`          | Day strain score, avg/max HR, calories                                |
+| `get_latest_workout`  | Most recent workout — sport, duration, strain, HR zones               |
+| `get_recovery_trend`  | Recovery scores over N days (default 7)                               |
+| `get_sleep_trend`     | Sleep data over N days (default 7)                                    |
+| `get_workout_history` | Recent workout history (default 5)                                    |
+| `get_profile`         | Profile + body measurements                                           |
+
+---
+
+## Setup
+
+### 1. Create a WHOOP developer app
+
+1. Go to [developer-dashboard.whoop.com](https://developer-dashboard.whoop.com)
+2. Sign in with your WHOOP account
+3. Create a new App:
+   - Name: `whoop-mcp` (or anything)
+   - Redirect URI: `http://localhost:8080/callback`
+   - Scopes: select all read scopes + `offline`
+4. Copy your **Client ID** and **Client Secret**
+
+### 2. Install
+
+```bash
+npm install -g whoop-mcp
+```
+
+### 3. Run one-time auth setup
+
+This opens your browser, you log into WHOOP, and your tokens are saved to `~/.whoop-mcp-tokens.json`:
+
+```bash
+WHOOP_CLIENT_ID=your_id WHOOP_CLIENT_SECRET=your_secret whoop-mcp-auth-setup
+```
+
+You only need to do this once. The server will auto-refresh tokens after that.
+
+### 4. Add to Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "whoop": {
+      "command": "whoop-mcp",
+      "env": {
+        "WHOOP_CLIENT_ID": "your_client_id",
+        "WHOOP_CLIENT_SECRET": "your_client_secret"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You should see a green "running" badge in **Settings → Developer**.
+
+### 5. Test it
+
+Open a new chat and ask:
+
+```
+How's my recovery today?
+```
+
+---
+
+## Example queries
+
+**Daily check-in:**
+
+```
+What's my recovery, sleep, and strain for today?
+```
+
+**Trend analysis:**
+
+```
+How has my HRV trended over the past 7 days?
+```
+
+**Workout correlation:**
+
+```
+Look at my workouts this week and my recovery scores
+the day after each one. Is there a pattern?
+```
+
+**Full briefing:**
+
+```
+Give me a complete health briefing — recovery, last
+night's sleep breakdown, and any workouts from yesterday
+```
+
+---
+
+## Pairing with Oura
+
+If you also use Oura Ring, you can run both MCP servers together and ask Claude to cross-reference:
+
+```json
+{
+  "mcpServers": {
+    "whoop": {
+      "command": "/path/to/whoop-mcp",
+      "env": { "WHOOP_ACCESS_TOKEN": "your_whoop_token" }
+    },
+    "oura": {
+      "command": "/path/to/oura-mcp",
+      "env": { "OURA_ACCESS_TOKEN": "your_oura_token" }
+    }
+  }
+}
+```
+
+Then ask:
+
+```
+Compare my WHOOP and Oura HRV readings for this week.
+Do they agree? Which is trending higher?
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/yourusername/whoop-mcp
+cd whoop-mcp
+npm install
+npm run build
+
+# Test locally
+WHOOP_ACCESS_TOKEN=your_token node dist/index.js
+```
+
+### Project structure
+
+```
+whoop-mcp/
+├── src/
+│   ├── index.ts   # MCP server + tool definitions
+│   └── whoop.ts   # WHOOP API client + formatters
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+---
+
+## Contributing
+
+PRs welcome. Some ideas for extension:
+
+- Heart rate time series data
+- Sleep stage timeline (light/deep/REM per hour)
+- Strain goal recommendations
+- Weekly summary tool
+
+---
+
+## License
+
+MIT
+
+---
+
+## Acknowledgements
+
+Built with the [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) and the [WHOOP Developer API](https://developer.whoop.com).

package/dist/auth-setup.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/auth-setup.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+// =============================================================================
+// auth-setup.ts — one-time OAuth2 setup for WHOOP
+//
+// Run this ONCE to get your initial access + refresh tokens.
+// After that, the MCP server handles refreshing automatically.
+//
+// USAGE:
+//   node dist/auth-setup.js
+//
+// WHAT IT DOES:
+//   1. Reads WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET from env
+//   2. Starts a local HTTP server on port 8080
+//   3. Prints an authorization URL — open it in your browser
+//   4. You log into WHOOP and authorize the app
+//   5. WHOOP redirects back to localhost:8080 with an auth code
+//   6. The script exchanges the code for tokens
+//   7. Saves tokens to ~/.whoop-mcp-tokens.json
+//   8. Done — you can now run the MCP server
+//
+// GETTING CLIENT_ID AND CLIENT_SECRET:
+//   1. Go to https://developer-dashboard.whoop.com
+//   2. Sign in with your WHOOP account
+//   3. Create a new App:
+//      - Name: "whoop-mcp" (or anything)
+//      - Redirect URI: http://localhost:8080/callback
+//      - Scopes: select all read scopes + offline
+//   4. Copy the Client ID and Client Secret
+//   5. Run: WHOOP_CLIENT_ID=xxx WHOOP_CLIENT_SECRET=yyy node dist/auth-setup.js
+// =============================================================================
+import { createServer } from 'http';
+import { saveTokens } from './auth.js';
+const clientId = process.env.WHOOP_CLIENT_ID;
+const clientSecret = process.env.WHOOP_CLIENT_SECRET;
+if (!clientId || !clientSecret) {
+    console.error('Missing required env variables.');
+    console.error('Usage: WHOOP_CLIENT_ID=xxx WHOOP_CLIENT_SECRET=yyy node dist/auth-setup.js');
+    process.exit(1);
+}
+const REDIRECT_URI = 'http://localhost:8080/callback';
+const AUTH_URL = 'https://api.prod.whoop.com/oauth/oauth2/auth';
+const TOKEN_URL = 'https://api.prod.whoop.com/oauth/oauth2/token';
+const SCOPES = 'offline read:recovery read:cycles read:workout read:sleep read:profile read:body_measurement';
+// Generate a random state string for CSRF protection
+const state = Math.random().toString(36).substring(2, 18);
+// Build the authorization URL
+const authUrl = new URL(AUTH_URL);
+authUrl.searchParams.set('response_type', 'code');
+authUrl.searchParams.set('client_id', clientId);
+authUrl.searchParams.set('redirect_uri', REDIRECT_URI);
+authUrl.searchParams.set('scope', SCOPES);
+authUrl.searchParams.set('state', state);
+console.log('\n=== WHOOP MCP — One-time Auth Setup ===\n');
+console.log('1. Open this URL in your browser:\n');
+console.log(`   ${authUrl.toString()}\n`);
+console.log('2. Log in to WHOOP and authorize the app');
+console.log('3. You\'ll be redirected back here automatically\n');
+console.log('Waiting for authorization...\n');
+// Start local server to receive the redirect
+const server = createServer(async (req, res) => {
+    if (!req.url?.startsWith('/callback')) {
+        res.writeHead(404);
+        res.end('Not found');
+        return;
+    }
+    const url = new URL(req.url, 'http://localhost:8080');
+    const code = url.searchParams.get('code');
+    const returnedState = url.searchParams.get('state');
+    const error = url.searchParams.get('error');
+    if (error) {
+        res.writeHead(400, { 'Content-Type': 'text/html' });
+        res.end(`<h1>Authorization failed</h1><p>${error}</p>`);
+        console.error(`Authorization failed: ${error}`);
+        server.close();
+        process.exit(1);
+    }
+    if (returnedState !== state) {
+        res.writeHead(400, { 'Content-Type': 'text/html' });
+        res.end('<h1>State mismatch — possible CSRF attack</h1>');
+        console.error('State mismatch');
+        server.close();
+        process.exit(1);
+    }
+    if (!code) {
+        res.writeHead(400, { 'Content-Type': 'text/html' });
+        res.end('<h1>No authorization code received</h1>');
+        server.close();
+        process.exit(1);
+    }
+    // Exchange code for tokens
+    console.log('Authorization code received — exchanging for tokens...');
+    try {
+        const body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            code,
+            client_id: clientId,
+            client_secret: clientSecret,
+            redirect_uri: REDIRECT_URI,
+        });
+        const tokenResponse = await fetch(TOKEN_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString(),
+        });
+        if (!tokenResponse.ok) {
+            const text = await tokenResponse.text();
+            throw new Error(`Token exchange failed (${tokenResponse.status}): ${text}`);
+        }
+        const data = await tokenResponse.json();
+        saveTokens({
+            access_token: data.access_token,
+            refresh_token: data.refresh_token,
+            expires_at: Date.now() + data.expires_in * 1000,
+        });
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(`
+      <h1>✅ Authorization successful!</h1>
+      <p>Your WHOOP tokens have been saved to <code>~/.whoop-mcp-tokens.json</code></p>
+      <p>You can close this tab and start using the MCP server.</p>
+    `);
+        console.log('\n✅ Success! Tokens saved to ~/.whoop-mcp-tokens.json');
+        console.log('\nAdd this to your claude_desktop_config.json:\n');
+        console.log(JSON.stringify({
+            mcpServers: {
+                whoop: {
+                    command: 'whoop-mcp', // or full path
+                    env: {
+                        WHOOP_CLIENT_ID: clientId,
+                        WHOOP_CLIENT_SECRET: clientSecret,
+                    },
+                },
+            },
+        }, null, 2));
+        console.log('\nThe server will auto-refresh tokens using the saved refresh token.\n');
+    }
+    catch (err) {
+        res.writeHead(500, { 'Content-Type': 'text/html' });
+        res.end(`<h1>Error</h1><p>${err}</p>`);
+        console.error('Token exchange failed:', err);
+    }
+    server.close();
+    process.exit(0);
+});
+server.listen(8080, () => {
+    // Try to auto-open the browser on macOS
+    import('child_process').then(({ exec }) => {
+        exec(`open "${authUrl.toString()}"`);
+    }).catch(() => {
+        // Non-macOS — user opens manually
+    });
+});
+//# sourceMappingURL=auth-setup.js.map

package/dist/auth-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-setup.js","sourceRoot":"","sources":["../src/auth-setup.ts"],"names":[],"mappings":"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"}

package/dist/auth.d.ts

@@ -0,0 +1,19 @@
+export interface TokenStore {
+    access_token: string;
+    refresh_token: string;
+    expires_at: number;
+}
+export interface OAuthConfig {
+    clientId: string;
+    clientSecret: string;
+}
+export declare function loadTokens(): TokenStore;
+export declare function saveTokens(tokens: TokenStore): void;
+export declare function isExpired(tokens: TokenStore): boolean;
+export declare function refreshTokens(tokens: TokenStore, config: OAuthConfig): Promise<TokenStore>;
+export declare class TokenManager {
+    private tokens;
+    private config;
+    constructor(config: OAuthConfig);
+    getAccessToken(): Promise<string>;
+}

package/dist/auth.js

@@ -0,0 +1,98 @@
+// =============================================================================
+// auth.ts — WHOOP OAuth2 token manager
+//
+// WHOOP uses OAuth2 authorization code flow. Access tokens expire every ~hour.
+// This module:
+//   1. Loads tokens from a local JSON file (~/.whoop-mcp-tokens.json)
+//   2. Checks expiry before every API call
+//   3. Refreshes automatically using the refresh token
+//   4. Saves updated tokens back to disk
+//
+// INITIAL SETUP (one-time):
+//   You need to do the first OAuth flow manually to get your initial tokens.
+//   Run: node dist/auth-setup.js
+//   This starts a local server, opens your browser, and saves your tokens.
+//
+// TOKEN FILE (~/.whoop-mcp-tokens.json):
+//   {
+//     "access_token": "...",
+//     "refresh_token": "...",
+//     "expires_at": 1234567890000   ← ms since epoch
+//   }
+// =============================================================================
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const TOKEN_FILE = join(homedir(), '.whoop-mcp-tokens.json');
+const TOKEN_URL = 'https://api.prod.whoop.com/oauth/oauth2/token';
+// Buffer: refresh 5 minutes before actual expiry
+const EXPIRY_BUFFER_MS = 5 * 60 * 1000;
+// ---- Token file I/O ---------------------------------------------------------
+export function loadTokens() {
+    if (!existsSync(TOKEN_FILE)) {
+        throw new Error(`No WHOOP tokens found at ${TOKEN_FILE}.\n` +
+            `Run: node dist/auth-setup.js\n` +
+            `This will open your browser to authorize the app and save your tokens.`);
+    }
+    try {
+        const raw = readFileSync(TOKEN_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Failed to parse token file at ${TOKEN_FILE}. Try running auth-setup again.`);
+    }
+}
+export function saveTokens(tokens) {
+    writeFileSync(TOKEN_FILE, JSON.stringify(tokens, null, 2), { mode: 0o600 }); // owner read/write only
+    process.stderr.write(`[whoop-mcp] Tokens saved to ${TOKEN_FILE}\n`);
+}
+// ---- Token refresh ----------------------------------------------------------
+export function isExpired(tokens) {
+    return Date.now() >= tokens.expires_at - EXPIRY_BUFFER_MS;
+}
+export async function refreshTokens(tokens, config) {
+    process.stderr.write('[whoop-mcp] Access token expired — refreshing...\n');
+    const body = new URLSearchParams({
+        grant_type: 'refresh_token',
+        refresh_token: tokens.refresh_token,
+        client_id: config.clientId,
+        client_secret: config.clientSecret,
+        scope: 'offline read:recovery read:cycles read:workout read:sleep read:profile read:body_measurement',
+    });
+    const response = await fetch(TOKEN_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: body.toString(),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to refresh WHOOP token (${response.status}): ${text}\n` +
+            `Your refresh token may have expired. Run: node dist/auth-setup.js`);
+    }
+    const data = await response.json();
+    const newTokens = {
+        access_token: data.access_token,
+        refresh_token: data.refresh_token ?? tokens.refresh_token, // WHOOP may or may not rotate refresh token
+        expires_at: Date.now() + data.expires_in * 1000,
+    };
+    saveTokens(newTokens);
+    process.stderr.write('[whoop-mcp] Token refreshed successfully\n');
+    return newTokens;
+}
+// ---- Token manager class ----------------------------------------------------
+// Used by WhoopClient to get a always-valid access token
+export class TokenManager {
+    tokens;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.tokens = loadTokens();
+    }
+    async getAccessToken() {
+        if (isExpired(this.tokens)) {
+            this.tokens = await refreshTokens(this.tokens, this.config);
+        }
+        return this.tokens.access_token;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+// =============================================================================
+// index.ts — whoop-mcp server
+//
+// Exposes WHOOP data as MCP tools that Claude can call.
+//
+// TOOLS:
+//   get_recovery        — today's recovery score, HRV, resting HR
+//   get_sleep           — last night's sleep breakdown
+//   get_strain          — today's day strain and calories
+//   get_latest_workout  — most recent workout
+//   get_recovery_trend  — recovery scores over N days
+//   get_sleep_trend     — sleep data over N days
+//   get_workout_history — recent workouts
+//   get_profile         — user profile and body measurements
+//
+// AUTH:
+//   Set WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET env variables.
+//   Run: node dist/auth-setup.js  (one-time setup — opens browser, saves tokens)
+//   Tokens are auto-refreshed and stored in ~/.whoop-mcp-tokens.json
+//
+// USAGE IN claude_desktop_config.json:
+//   {
+//     "mcpServers": {
+//       "whoop": {
+//         "command": "/path/to/whoop-mcp",
+//         "env": { "WHOOP_CLIENT_ID": "your_id", "WHOOP_CLIENT_SECRET": "your_secret" }
+//       }
+//     }
+//   }
+// =============================================================================
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { WhoopClient, formatRecovery, formatSleep, formatWorkout, formatCycle, } from './whoop.js';
+// ---- Validate env -----------------------------------------------------------
+const clientId = process.env.WHOOP_CLIENT_ID;
+const clientSecret = process.env.WHOOP_CLIENT_SECRET;
+if (!clientId || !clientSecret) {
+    process.stderr.write('[whoop-mcp] Error: WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET are required.\n' +
+        '[whoop-mcp] Run: node dist/auth-setup.js to complete one-time setup.\n');
+    process.exit(1);
+}
+const client = new WhoopClient({ clientId, clientSecret });
+// ---- MCP Server -------------------------------------------------------------
+const server = new McpServer({
+    name: 'whoop',
+    version: '1.0.0',
+});
+// Helper — wraps tool handlers with error handling
+function safe(fn) {
+    return fn()
+        .then(text => ({ content: [{ type: 'text', text }] }))
+        .catch(err => ({
+        content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+    }));
+}
+// ---- Tools ------------------------------------------------------------------
+// 1. Today's recovery
+server.tool('get_recovery', "Get the user's most recent WHOOP recovery score, HRV, resting heart rate, and SpO2", {}, () => safe(async () => {
+    const recovery = await client.getLatestRecovery();
+    if (!recovery)
+        return 'No recovery data available yet. Make sure your WHOOP is synced.';
+    return formatRecovery(recovery);
+}));
+// 2. Last night's sleep
+server.tool('get_sleep', "Get the user's most recent WHOOP sleep data including duration, sleep stages (light, deep/SWS, REM), efficiency, and respiratory rate", {}, () => safe(async () => {
+    const sleep = await client.getLatestSleep();
+    if (!sleep)
+        return 'No sleep data available. Make sure your WHOOP is synced.';
+    return formatSleep(sleep);
+}));
+// 3. Today's strain
+server.tool('get_strain', "Get the user's current day strain score, average heart rate, and calories burned from WHOOP", {}, () => safe(async () => {
+    const cycle = await client.getLatestCycle();
+    if (!cycle)
+        return 'No strain data available yet today.';
+    return formatCycle(cycle);
+}));
+// 4. Latest workout
+server.tool('get_latest_workout', "Get the user's most recent WHOOP workout — sport type, duration, strain, heart rate zones, and calories", {}, () => safe(async () => {
+    const workout = await client.getLatestWorkout();
+    if (!workout)
+        return 'No recent workouts found.';
+    return formatWorkout(workout);
+}));
+// 5. Recovery trend
+server.tool('get_recovery_trend', "Get the user's WHOOP recovery scores over the past N days (default 7) for trend analysis", { days: z.number().min(1).max(25).default(7).describe('Number of days to look back (max 25)') }, ({ days }) => safe(async () => {
+    const start = new Date();
+    start.setDate(start.getDate() - days);
+    const records = await client.getRecoveryCollection(start.toISOString(), undefined, days);
+    if (records.length === 0)
+        return 'No recovery data found for this period.';
+    return records.map(formatRecovery).join('\n\n---\n\n');
+}));
+// 6. Sleep trend
+server.tool('get_sleep_trend', "Get the user's WHOOP sleep data over the past N days (default 7) for trend analysis", { days: z.number().min(1).max(25).default(7).describe('Number of days to look back (max 25)') }, ({ days }) => safe(async () => {
+    const start = new Date();
+    start.setDate(start.getDate() - days);
+    const records = await client.getSleepCollection(start.toISOString(), undefined, days);
+    if (records.length === 0)
+        return 'No sleep data found for this period.';
+    // Filter to main sleeps only (exclude naps) unless there are none
+    const mainSleeps = records.filter(s => !s.nap);
+    const toShow = mainSleeps.length > 0 ? mainSleeps : records;
+    return toShow.map(formatSleep).join('\n\n---\n\n');
+}));
+// 7. Workout history
+server.tool('get_workout_history', "Get the user's recent WHOOP workout history — useful for understanding training load and patterns", { count: z.number().min(1).max(25).default(5).describe('Number of workouts to retrieve (max 25)') }, ({ count }) => safe(async () => {
+    const workouts = await client.getWorkoutCollection(undefined, undefined, count);
+    if (workouts.length === 0)
+        return 'No workouts found.';
+    return workouts.map(formatWorkout).join('\n\n---\n\n');
+}));
+// 8. User profile
+server.tool('get_profile', "Get the user's WHOOP profile (name, email) and body measurements (height, weight, max heart rate)", {}, () => safe(async () => {
+    const [profile, body] = await Promise.all([
+        client.getProfile(),
+        client.getBodyMeasurements(),
+    ]);
+    return [
+        `Name: ${profile.first_name} ${profile.last_name}`,
+        `Email: ${profile.email}`,
+        `Height: ${(body.height_meter * 100).toFixed(0)} cm`,
+        `Weight: ${body.weight_kilogram.toFixed(1)} kg`,
+        `Max Heart Rate: ${body.max_heart_rate} bpm`,
+    ].join('\n');
+}));
+// ---- Start ------------------------------------------------------------------
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write('[whoop-mcp] Server running\n');
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,gFAAgF;AAChF,8BAA8B;AAC9B,EAAE;AACF,wDAAwD;AACxD,EAAE;AACF,SAAS;AACT,kEAAkE;AAClE,uDAAuD;AACvD,0DAA0D;AAC1D,8CAA8C;AAC9C,sDAAsD;AACtD,iDAAiD;AACjD,0CAA0C;AAC1C,6DAA6D;AAC7D,EAAE;AACF,QAAQ;AACR,+DAA+D;AAC/D,iFAAiF;AACjF,qEAAqE;AACrE,EAAE;AACF,uCAAuC;AACvC,MAAM;AACN,sBAAsB;AACtB,mBAAmB;AACnB,2CAA2C;AAC3C,wFAAwF;AACxF,UAAU;AACV,QAAQ;AACR,MAAM;AACN,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAEhF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAErD,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4EAA4E;QAC5E,wEAAwE,CACzE,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;AAE3D,gFAAgF;AAEhF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,mDAAmD;AACnD,SAAS,IAAI,CAAC,EAAyB;IACrC,OAAO,EAAE,EAAE;SACR,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SAC9D,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;KACzG,CAAC,CAAC,CAAC;AACR,CAAC;AAED,gFAAgF;AAEhF,sBAAsB;AACtB,MAAM,CAAC,IAAI,CACT,cAAc,EACd,oFAAoF,EACpF,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO,iEAAiE,CAAC;IACxF,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC,CACH,CAAC;AAEF,wBAAwB;AACxB,MAAM,CAAC,IAAI,CACT,WAAW,EACX,uIAAuI,EACvI,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,0DAA0D,CAAC;IAC9E,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CACH,CAAC;AAEF,oBAAoB;AACpB,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,6FAA6F,EAC7F,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,qCAAqC,CAAC;IACzD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CACH,CAAC;AAEF,oBAAoB;AACpB,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,yGAAyG,EACzG,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,2BAA2B,CAAC;IACjD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC,CAAC,CACH,CAAC;AAEF,oBAAoB;AACpB,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,0FAA0F,EAC1F,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EAAE,EAC/F,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IAC5B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACzF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,yCAAyC,CAAC;IAC3E,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzD,CAAC,CAAC,CACH,CAAC;AAEF,iBAAiB;AACjB,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,qFAAqF,EACrF,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EAAE,EAC/F,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IAC5B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACtF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,sCAAsC,CAAC;IACxE,kEAAkE;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACrD,CAAC,CAAC,CACH,CAAC;AAEF,qBAAqB;AACrB,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,mGAAmG,EACnG,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC,EAAE,EACnG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IAC7B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAChF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACvD,OAAO,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzD,CAAC,CAAC,CACH,CAAC;AAEF,kBAAkB;AAClB,MAAM,CAAC,IAAI,CACT,aAAa,EACb,mGAAmG,EACnG,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxC,MAAM,CAAC,UAAU,EAAE;QACnB,MAAM,CAAC,mBAAmB,EAAE;KAC7B,CAAC,CAAC;IACH,OAAO;QACL,SAAS,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE;QAClD,UAAU,OAAO,CAAC,KAAK,EAAE;QACzB,WAAW,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QACpD,WAAW,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QAC/C,mBAAmB,IAAI,CAAC,cAAc,MAAM;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC,CACH,CAAC;AAEF,gFAAgF;AAEhF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC"}

package/dist/whoop.d.ts

@@ -0,0 +1,135 @@
+import { OAuthConfig } from './auth.js';
+export interface WhoopProfile {
+    user_id: number;
+    email: string;
+    first_name: string;
+    last_name: string;
+}
+export interface WhoopBodyMeasurements {
+    height_meter: number;
+    weight_kilogram: number;
+    max_heart_rate: number;
+}
+export interface WhoopCycleScore {
+    strain: number;
+    kilojoule: number;
+    average_heart_rate: number;
+    max_heart_rate: number;
+}
+export interface WhoopCycle {
+    id: number;
+    user_id: number;
+    created_at: string;
+    updated_at: string;
+    start: string;
+    end: string | null;
+    timezone_offset: string;
+    score_state: 'SCORED' | 'PENDING_SCORE' | 'UNSCORABLE';
+    score: WhoopCycleScore | null;
+}
+export interface WhoopRecoveryScore {
+    user_calibrating: boolean;
+    recovery_score: number;
+    resting_heart_rate: number;
+    hrv_rmssd_milli: number;
+    spo2_percentage: number | null;
+    skin_temp_celsius: number | null;
+}
+export interface WhoopRecovery {
+    cycle_id: number;
+    sleep_id: number;
+    user_id: number;
+    created_at: string;
+    updated_at: string;
+    score_state: 'SCORED' | 'PENDING_SCORE' | 'UNSCORABLE';
+    score: WhoopRecoveryScore | null;
+}
+export interface WhoopSleepScore {
+    stage_summary: {
+        total_in_bed_time_milli: number;
+        total_awake_time_milli: number;
+        total_no_data_time_milli: number;
+        total_light_sleep_time_milli: number;
+        total_slow_wave_sleep_time_milli: number;
+        total_rem_sleep_time_milli: number;
+        sleep_cycle_count: number;
+        disturbance_count: number;
+    };
+    sleep_needed: {
+        baseline_milli: number;
+        need_from_sleep_debt_milli: number;
+        need_from_recent_strain_milli: number;
+        need_from_recent_nap_milli: number;
+    };
+    respiratory_rate: number | null;
+    sleep_performance_percentage: number | null;
+    sleep_consistency_percentage: number | null;
+    sleep_efficiency_percentage: number | null;
+}
+export interface WhoopSleep {
+    id: number;
+    user_id: number;
+    created_at: string;
+    updated_at: string;
+    start: string;
+    end: string;
+    timezone_offset: string;
+    nap: boolean;
+    score_state: 'SCORED' | 'PENDING_SCORE' | 'UNSCORABLE';
+    score: WhoopSleepScore | null;
+}
+export interface WhoopWorkoutScore {
+    strain: number;
+    average_heart_rate: number;
+    max_heart_rate: number;
+    kilojoule: number;
+    percent_recorded: number;
+    distance_meter: number | null;
+    altitude_gain_meter: number | null;
+    altitude_change_meter: number | null;
+    zone_duration: {
+        zone_zero_milli: number | null;
+        zone_one_milli: number | null;
+        zone_two_milli: number | null;
+        zone_three_milli: number | null;
+        zone_four_milli: number | null;
+        zone_five_milli: number | null;
+    };
+}
+export interface WhoopWorkout {
+    id: number;
+    user_id: number;
+    created_at: string;
+    updated_at: string;
+    start: string;
+    end: string;
+    timezone_offset: string;
+    sport_id: number;
+    score_state: 'SCORED' | 'PENDING_SCORE' | 'UNSCORABLE';
+    score: WhoopWorkoutScore | null;
+}
+export interface PaginatedResponse<T> {
+    records: T[];
+    next_token: string | null;
+}
+export declare const SPORT_NAMES: Record<number, string>;
+export declare class WhoopClient {
+    private tokenManager;
+    constructor(config: OAuthConfig);
+    private request;
+    getProfile(): Promise<WhoopProfile>;
+    getBodyMeasurements(): Promise<WhoopBodyMeasurements>;
+    getLatestRecovery(): Promise<WhoopRecovery | null>;
+    getRecoveryCollection(start?: string, end?: string, limit?: number): Promise<WhoopRecovery[]>;
+    getLatestSleep(): Promise<WhoopSleep | null>;
+    getSleepCollection(start?: string, end?: string, limit?: number): Promise<WhoopSleep[]>;
+    getLatestCycle(): Promise<WhoopCycle | null>;
+    getCycleCollection(start?: string, end?: string, limit?: number): Promise<WhoopCycle[]>;
+    getLatestWorkout(): Promise<WhoopWorkout | null>;
+    getWorkoutCollection(start?: string, end?: string, limit?: number): Promise<WhoopWorkout[]>;
+}
+export declare function millisToHours(ms: number): string;
+export declare function formatRecovery(r: WhoopRecovery): string;
+export declare function formatSleep(s: WhoopSleep): string;
+export declare function formatWorkout(w: WhoopWorkout): string;
+export declare function formatCycle(c: WhoopCycle): string;

package/dist/whoop.js

@@ -0,0 +1,204 @@
+// =============================================================================
+// whoop.ts — WHOOP API client
+//
+// Wraps all WHOOP v2 REST API endpoints.
+// Auth: OAuth2 with automatic token refresh via TokenManager
+// Base URL: https://api.prod.whoop.com/developer
+//
+// API docs: https://developer.whoop.com/api
+// =============================================================================
+import { TokenManager } from './auth.js';
+const BASE_URL = 'https://api.prod.whoop.com/developer';
+// ---- Sport ID map -----------------------------------------------------------
+export const SPORT_NAMES = {
+    '-1': 'Activity',
+    0: 'Running', 1: 'Cycling', 16: 'Baseball', 17: 'Basketball',
+    18: 'Rowing', 19: 'Fencing', 20: 'Field Hockey', 21: 'Football',
+    22: 'Golf', 24: 'Ice Hockey', 25: 'Lacrosse', 27: 'Rugby',
+    28: 'Sailing', 29: 'Skiing', 30: 'Soccer', 31: 'Softball',
+    32: 'Squash', 33: 'Swimming', 34: 'Tennis', 35: 'Track & Field',
+    36: 'Volleyball', 37: 'Water Polo', 38: 'Wrestling', 39: 'Boxing',
+    42: 'Dance', 43: 'Pilates', 44: 'Yoga', 45: 'Weightlifting',
+    47: 'Cross Country Skiing', 48: 'Functional Fitness', 49: 'Duathlon',
+    51: 'Gymnastics', 52: 'Hiking', 53: 'Horseback Riding', 55: 'Kayaking',
+    56: 'Martial Arts', 57: 'Mountain Biking', 59: 'Obstacle Course Racing',
+    60: 'Olympic Weightlifting', 61: 'Paddle Tennis', 62: 'Motorcycling',
+    63: 'Powerlifting', 64: 'Rock Climbing', 65: 'Paddleboarding',
+    66: 'Triathlon', 67: 'Walking', 68: 'Surfing', 69: 'Elliptical',
+    70: 'Stairmaster', 71: 'Meditation', 73: 'Other', 74: 'Diving',
+    75: 'Operations - Tactical', 76: 'Operations - Medical',
+    77: 'Operations - Flying', 78: 'Operations - Water',
+    82: 'Commuting', 83: 'Gaming', 84: 'Snowboarding', 85: 'Motocross',
+    86: 'Caddying', 87: 'Obstacle Racing', 88: 'Motor Racing', 89: 'HIIT',
+    90: 'Spin', 91: 'Jiu Jitsu', 92: 'Manual Labor', 93: 'Cricket',
+    94: 'Pickleball', 95: 'Inline Skating', 96: 'Box Fitness', 97: 'Spikeball',
+    98: 'Wheelchair Pushing', 99: 'Paddle Sports', 100: 'Barre',
+    101: 'Stage Performance', 102: 'High Stress Work', 103: 'Ice Bath',
+    104: 'Coaching', 105: 'Ice Skating', 106: 'Cross-training', 107: 'Parkour',
+    108: 'Badminton', 109: 'Table Tennis', 110: 'Racquetball', 111: 'Jump Rope',
+    112: 'Australian Football', 113: 'Skateboarding', 114: 'Coaching Sports',
+    115: 'Sauna', 116: 'Disc Golf', 117: 'Ultimate Frisbee', 118: 'Snorkeling',
+    119: 'Esports', 121: 'Pickleball',
+};
+// ---- API Client -------------------------------------------------------------
+export class WhoopClient {
+    tokenManager;
+    constructor(config) {
+        this.tokenManager = new TokenManager(config);
+    }
+    async request(path, params) {
+        // Always get a fresh (auto-refreshed if needed) token
+        const token = await this.tokenManager.getAccessToken();
+        const url = new URL(`${BASE_URL}${path}`);
+        if (params) {
+            Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`WHOOP API error ${response.status}: ${body}`);
+        }
+        return response.json();
+    }
+    // User
+    async getProfile() {
+        return this.request('/v2/user/profile/basic');
+    }
+    async getBodyMeasurements() {
+        return this.request('/v2/user/measurement/body');
+    }
+    // Recovery
+    async getLatestRecovery() {
+        const data = await this.request('/v2/recovery', { limit: '1' });
+        return data.records[0] ?? null;
+    }
+    async getRecoveryCollection(start, end, limit = 7) {
+        const params = { limit: String(limit) };
+        if (start)
+            params.start = start;
+        if (end)
+            params.end = end;
+        const data = await this.request('/v2/recovery', params);
+        return data.records;
+    }
+    // Sleep
+    async getLatestSleep() {
+        const data = await this.request('/v2/activity/sleep', { limit: '1' });
+        const mainSleeps = data.records.filter(s => !s.nap);
+        return mainSleeps[0] ?? data.records[0] ?? null;
+    }
+    async getSleepCollection(start, end, limit = 7) {
+        const params = { limit: String(Math.min(limit, 25)) };
+        if (start)
+            params.start = start;
+        if (end)
+            params.end = end;
+        const data = await this.request('/v2/activity/sleep', params);
+        return data.records;
+    }
+    // Cycles
+    async getLatestCycle() {
+        const data = await this.request('/v2/cycle', { limit: '1' });
+        return data.records[0] ?? null;
+    }
+    async getCycleCollection(start, end, limit = 7) {
+        const params = { limit: String(Math.min(limit, 25)) };
+        if (start)
+            params.start = start;
+        if (end)
+            params.end = end;
+        const data = await this.request('/v2/cycle', params);
+        return data.records;
+    }
+    // Workouts
+    async getLatestWorkout() {
+        const data = await this.request('/v2/activity/workout', { limit: '1' });
+        return data.records[0] ?? null;
+    }
+    async getWorkoutCollection(start, end, limit = 10) {
+        const params = { limit: String(Math.min(limit, 25)) };
+        if (start)
+            params.start = start;
+        if (end)
+            params.end = end;
+        const data = await this.request('/v2/activity/workout', params);
+        return data.records;
+    }
+}
+// ---- Formatting helpers -----------------------------------------------------
+export function millisToHours(ms) {
+    const h = Math.floor(ms / 3600000);
+    const m = Math.floor((ms % 3600000) / 60000);
+    return `${h}h ${m}m`;
+}
+export function formatRecovery(r) {
+    if (r.score_state !== 'SCORED' || !r.score) {
+        return `Recovery for cycle ${r.cycle_id}: ${r.score_state}`;
+    }
+    const s = r.score;
+    const zone = s.recovery_score >= 67 ? '🟢 Green' : s.recovery_score >= 34 ? '🟡 Yellow' : '🔴 Red';
+    return [
+        `Recovery Score: ${s.recovery_score}/100 (${zone})`,
+        `HRV: ${s.hrv_rmssd_milli.toFixed(1)}ms`,
+        `Resting Heart Rate: ${s.resting_heart_rate} bpm`,
+        s.spo2_percentage ? `SpO2: ${s.spo2_percentage.toFixed(1)}%` : null,
+        s.skin_temp_celsius ? `Skin Temp: ${s.skin_temp_celsius.toFixed(1)}°C` : null,
+        `Date: ${new Date(r.created_at).toLocaleDateString()}`,
+    ].filter(Boolean).join('\n');
+}
+export function formatSleep(s) {
+    if (s.score_state !== 'SCORED' || !s.score) {
+        return `Sleep on ${new Date(s.start).toLocaleDateString()}: ${s.score_state}`;
+    }
+    const sc = s.score;
+    const ss = sc.stage_summary;
+    return [
+        `Sleep: ${new Date(s.start).toLocaleDateString()} (${s.nap ? 'Nap' : 'Main sleep'})`,
+        `Performance: ${sc.sleep_performance_percentage?.toFixed(0) ?? 'N/A'}%`,
+        `Efficiency: ${sc.sleep_efficiency_percentage?.toFixed(0) ?? 'N/A'}%`,
+        `Total in bed: ${millisToHours(ss.total_in_bed_time_milli)}`,
+        `Awake: ${millisToHours(ss.total_awake_time_milli)}`,
+        `Light sleep: ${millisToHours(ss.total_light_sleep_time_milli)}`,
+        `Deep sleep (SWS): ${millisToHours(ss.total_slow_wave_sleep_time_milli)}`,
+        `REM sleep: ${millisToHours(ss.total_rem_sleep_time_milli)}`,
+        `Disturbances: ${ss.disturbance_count}`,
+        sc.respiratory_rate ? `Respiratory rate: ${sc.respiratory_rate.toFixed(1)} breaths/min` : null,
+    ].filter(Boolean).join('\n');
+}
+export function formatWorkout(w) {
+    const sportName = SPORT_NAMES[w.sport_id] ?? `Sport #${w.sport_id}`;
+    if (w.score_state !== 'SCORED' || !w.score) {
+        return `${sportName} on ${new Date(w.start).toLocaleDateString()}: ${w.score_state}`;
+    }
+    const s = w.score;
+    const duration = (new Date(w.end).getTime() - new Date(w.start).getTime()) / 60000;
+    return [
+        `Workout: ${sportName}`,
+        `Date: ${new Date(w.start).toLocaleDateString()}`,
+        `Duration: ${Math.round(duration)} min`,
+        `Strain: ${s.strain.toFixed(1)}/21`,
+        `Avg HR: ${s.average_heart_rate} bpm`,
+        `Max HR: ${s.max_heart_rate} bpm`,
+        `Calories: ${(s.kilojoule / 4.184).toFixed(0)} kcal`,
+        s.distance_meter ? `Distance: ${(s.distance_meter / 1000).toFixed(2)} km` : null,
+    ].filter(Boolean).join('\n');
+}
+export function formatCycle(c) {
+    if (c.score_state !== 'SCORED' || !c.score) {
+        return `Cycle ${new Date(c.start).toLocaleDateString()}: ${c.score_state}`;
+    }
+    const s = c.score;
+    return [
+        `Day Strain: ${s.strain.toFixed(1)}/21`,
+        `Avg HR: ${s.average_heart_rate} bpm`,
+        `Max HR: ${s.max_heart_rate} bpm`,
+        `Calories: ${(s.kilojoule / 4.184).toFixed(0)} kcal`,
+        `Date: ${new Date(c.start).toLocaleDateString()}`,
+    ].join('\n');
+}
+//# sourceMappingURL=whoop.js.map

package/dist/whoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoop.js","sourceRoot":"","sources":["../src/whoop.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@souravpn/whoop-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for WHOOP — gives Claude access to your recovery, sleep, strain, and workout data",
+  "keywords": [
+    "mcp",
+    "whoop",
+    "health",
+    "fitness",
+    "claude",
+    "ai"
+  ],
+  "author": "Sourav Nayak",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "whoop-mcp": "dist/index.js",
+    "whoop-mcp-auth-setup": "dist/auth-setup.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "auth-setup": "node dist/auth-setup.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}