Whoop API MCP Server
MCP server for interacting with the Whoop API to retrieve fitness and health data
Overview
The Whoop API MCP Server is a Mission Control Protocol server designed to interact with the Whoop API, allowing users to retrieve various fitness and health data seamlessly.
To use the Whoop API MCP Server, clone the repository, install the necessary dependencies, set up your environment variables with your Whoop API credentials, and start the server. You can then access the MCP endpoint and authenticate users to retrieve their fitness data.
- OAuth 2.0 authentication with Whoop API - Access to user profile, recovery, sleep, workout, and menstrual cycle data - MCP-compliant discovery endpoint - Clean error handling and logging
- Integrating Whoop fitness data into health and fitness applications.
- Analyzing user recovery and sleep patterns for better health insights.
- Tracking menstrual cycles in fitness applications.
Add to your AI client
Use these steps to connect Whoop API MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"whoop-api-mcp-ryanlisse": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-whoop-api-mcp-ryanlisse"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"whoop-api-mcp-ryanlisse": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-whoop-api-mcp-ryanlisse"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"whoop-api-mcp-ryanlisse": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-whoop-api-mcp-ryanlisse"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"whoop-api-mcp-ryanlisse": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-whoop-api-mcp-ryanlisse"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"whoop-api-mcp-ryanlisse": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-whoop-api-mcp-ryanlisse"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"whoop-api-mcp-ryanlisse": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-whoop-api-mcp-ryanlisse"
]
}
}
}FAQ
What data can I retrieve using this server?
You can retrieve user profile information, recovery data, sleep data, workout data, and menstrual cycle tracking data.
Do I need a Whoop developer account?
Yes, you need a Whoop developer account and API credentials to use this server.
Is there any cost associated with using the Whoop API?
The usage of the Whoop API may depend on your account type and the terms set by Whoop.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2924,"uuid":"e1ec0a0b-d3df-4a39-93c3-143a6caa8d97","name":"whoop-api-mcp","title":"Whoop API MCP Server","description":"MCP server for interacting with the Whoop API to retrieve fitness and health data","avatar_url":"https://avatars.githubusercontent.com/u/57917217?v=4","created_at":"2025-03-16T04:12:21.815Z","updated_at":"2025-03-16T06:10:57.325Z","status":"created","author_name":"RyanLisse","author_avatar_url":"https://avatars.githubusercontent.com/u/57917217?v=4","tags":"whoop-api,fitness-data,health-data","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/RyanLisse/whoop-api-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-16 00:45:47\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]