WHOOP Developer Account

To self-host Wellpipe, you need your own WHOOP API credentials.

Why This Is Needed

The cloud version of Wellpipe uses shared API credentials. When self-hosting, you need your own credentials to:

• Authenticate with WHOOP's API
• Receive OAuth callbacks locally
• Access your personal data

Step 1: Create Developer Account

1. Go to developer.whoop.com
2. Sign in with your WHOOP account
3. Accept the developer terms

Step 2: Create an Application

1. Click Create Application or New App
2. Fill in the application details:

Field	Value
Name	Wellpipe (or any name)
Description	Personal health data access
Redirect URI	http://localhost:3000/api/callback/whoop

Important: The Redirect URI must be exactly http://localhost:3000/api/callback/whoop

Step 3: Get Credentials

After creating your app:

1. Copy your Client ID
2. Copy your Client Secret

Keep these safe—you'll need them for configuration.

Step 4: Configure Wellpipe

Add credentials to your .env file:

WHOOP_CLIENT_ID=your_client_id_here
WHOOP_CLIENT_SECRET=your_client_secret_here

Or run wellpipe init and paste them when prompted.

Required Scopes

Wellpipe requests these scopes during authentication:

Scope	Access
read:profile	User profile
read:sleep	Sleep data
read:recovery	Recovery data
read:workout	Workout data
read:cycles	Daily cycles
read:body	Body measurements
offline	Refresh tokens

All scopes are read-only. The CLI requests all available read scopes.

Redirect URI Troubleshooting

"Invalid redirect URI"

The URI in WHOOP's app settings must exactly match:

http://localhost:3000/api/callback/whoop

Check for:

• Extra spaces
• Trailing slashes
• https vs http
• Port number

Using a Different Port

If port 3000 is in use, you can use a different port:

1. Update WHOOP app redirect URI to: http://localhost:3001/api/callback/whoop
2. Run auth with port flag: wellpipe auth whoop --port 3001

Rate Limits

WHOOP developer API has rate limits:

• Varies by endpoint
• Personal use is typically well within limits
• Excessive requests may be throttled

Developer Account vs Regular Account

Feature	Regular Account	Developer Account
Use WHOOP app	Yes	Yes
Use cloud Wellpipe	Yes	Yes
Self-host Wellpipe	No	Yes
Create apps	No	Yes

Your developer account is the same as your regular WHOOP account—just with added developer features.

Security Notes

• Never share your Client Secret
• Add .env to .gitignore
• Regenerate credentials if compromised
• Only you can access data via your credentials

Next Steps

Once you have credentials:

1. Complete CLI setup
2. Run wellpipe auth whoop to authenticate
3. Configure Claude Desktop