Skip to main content

Common Issues

Quick solutions for the most frequent problems.

"I can't access your health data"​

Your AI assistant says it doesn't have access to your health data.

Quick Fix Checklist:

  1. ✅ Are you using the right platform? (Claude Desktop with config, or Custom GPT)
  2. ✅ Is your API key correct?
  3. ✅ Is WHOOP connected in your dashboard?
  4. ✅ Has your token expired? (Check dashboard)

Claude Desktop:

  • Verify claude_desktop_config.json has the correct API key
  • Restart Claude Desktop completely (Cmd+Q, not just close)
  • Look for the tools icon (hammer/wrench)

ChatGPT:

  • Make sure you're using your Custom GPT, not regular ChatGPT
  • Check that the Action is configured with Bearer authentication
  • Verify your API key in the Action settings

"No data available"​

Queries return empty or say no data was found.

Possible causes:

CauseSolution
Data not syncedWait 15-30 min after waking, check WHOOP app
Wrong date rangeTry "this week" instead of specific dates
Token expiredReconnect WHOOP in dashboard
New userNeed at least one night of data

"Rate limit exceeded"​

You've hit your monthly request limit.

Check your usage:

  1. Go to app.wellpipe.io
  2. View your usage stats
  3. Free tier: 1,000 requests/month
  4. Pro tier: Unlimited

Options:

  • Wait until next month (resets on the 1st)
  • Upgrade to Pro ($5/month)
  • Reduce query frequency

"Authentication failed" or "Invalid token"​

Your connection to WHOOP has expired or is invalid.

Fix:

  1. Go to app.wellpipe.io
  2. Click Reconnect on the WHOOP card
  3. Authorize on WHOOP again

"Connection refused" or Network Errors​

Can't connect to Wellpipe services.

Check:

  1. Your internet connection
  2. Wellpipe service status
  3. Firewall settings (for Claude Desktop)

If using Claude Desktop, ensure Node.js can make outbound HTTPS requests.

Claude Desktop: Tools Not Appearing​

The hammer/wrench icon doesn't show in Claude Desktop.

Fix:

  1. Open your config file:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Verify JSON syntax is valid (use a JSON validator)
  3. Check the API key is correct
  4. Completely quit Claude Desktop (Cmd+Q on Mac)
  5. Reopen Claude Desktop

Common config mistakes:

  • Missing comma between servers
  • Typo in mcpServers key
  • Extra spaces in API key

Wrong WHOOP Account​

Connected to the wrong WHOOP account.

Fix:

  1. Click Disconnect in dashboard
  2. Clear cookies for whoop.com in your browser
  3. Click Connect again
  4. Log into the correct WHOOP account

Or use an incognito/private browser window.

Data Seems Outdated​

WHOOP app shows newer data than Wellpipe returns.

Causes:

  • WHOOP API propagation delay (5-10 minutes)
  • Cached responses (try asking again)

Fix:

  • Wait a few minutes
  • Ask specifically for "today" or "last night"
  • Try disconnecting and reconnecting WHOOP

Still Stuck?​

If none of these solutions work:

  1. Check the specific page:

  2. Report an issue:

    • GitHub Issues
    • Include: What you tried, error messages, platform details