Claude Desktop Setup

Claude Desktop provides the best Wellpipe experience with native MCP (Model Context Protocol) support. This gives Claude direct access to 21 health data tools.

Prerequisites

• Claude Desktop installed on Mac or Windows
• A Wellpipe account with a connected health provider
• Your Wellpipe API key

Step 1: Get Your API Key

1. Go to your Wellpipe dashboard
2. Copy your API key from the dashboard

Step 2: Open the Config File

Claude Desktop uses a JSON configuration file for MCP servers.

macOS

Open Terminal and run:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Or navigate to: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Open File Explorer and navigate to:

%APPDATA%\Claude\claude_desktop_config.json

File Doesn't Exist?

If the file doesn't exist, create it. Make sure Claude Desktop is installed first.

Step 3: Add Wellpipe Configuration

Add the following to your config file, replacing YOUR_API_KEY with your actual API key:

{
  "mcpServers": {
    "wellpipe": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://wellpipe.io/api/mcp/auth",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

If You Already Have MCP Servers

If you already have other MCP servers configured, add Wellpipe to the existing mcpServers object:

{
  "mcpServers": {
    "existing-server": {
      "command": "...",
      "args": ["..."]
    },
    "wellpipe": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://wellpipe.io/api/mcp/auth",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Step 4: Restart Claude Desktop

Completely quit Claude Desktop:

• Mac: Cmd+Q (not just close the window)
• Windows: Right-click the system tray icon and quit

Then reopen Claude Desktop.

Step 5: Verify Connection

Look for the tools icon (hammer/wrench) in the Claude Desktop interface. Click it to see the available Wellpipe tools.

You should see tools like:

• get-recent-sleep
• get-recovery-by-cycle-id
• get-workout-collection
• And more...

Start Chatting

Now you can ask Claude about your health data naturally:

"How did I sleep last night?"

"What's my recovery score today?"

"Show me my workout trends this month"

Claude will automatically use the appropriate Wellpipe tools to fetch and analyze your data.

Troubleshooting

Tools Icon Not Appearing

1. Make sure the config file is valid JSON (no syntax errors)
2. Check that the file is in the correct location
3. Completely quit and restart Claude Desktop (Cmd+Q on Mac)

"Server not found" or Connection Errors

1. Verify your API key is correct
2. Make sure you have Node.js installed (npx requires it)
3. Check your internet connection

"No data available" Responses

1. Verify your health provider is connected in the Wellpipe dashboard
2. Check that your provider has recent data (WHOOP syncs after you wake up)

Rate Limit Errors

Free accounts have 1,000 requests per month. If you're hitting limits:

1. Check your usage in the dashboard
2. Consider upgrading to Pro for unlimited requests

Available Tools

With Wellpipe connected, Claude has access to these tools:

Category	Tools
Sleep	get-sleep-collection, get-sleep-by-id, get-recent-sleep, get-sleep-summary
Recovery	get-recovery-collection, get-recovery-by-cycle-id, get-recent-recovery, get-recovery-summary
Workouts	get-workout-collection, get-workout-by-id, get-recent-workouts, get-workout-summary
Cycles	get-cycle-collection, get-cycle-by-id, get-recent-cycles, get-cycle-summary
Profile	get-user-profile, get-body-measurement
Auth	authenticate-whoop, complete-whoop-auth, check-auth-status

See the Tools Reference for detailed documentation on each tool.