MCP server for 8sleep
Documentation
Eight Sleep MCP
A Model Context Protocol (MCP) server for accessing Eight Sleep Pod data.
Setup
Prerequisites
- Node.js (v16+)
- Eight Sleep account
Installation
1. Clone the repository
2. Run:
npm install
npm run buildConfiguration
Getting Your User ID
You need to get your Eight Sleep user ID once and add it to your configuration. This prevents the client from having to authenticate with email/password on every request. You have two options:
Option 1: Direct API Call
1. ```bash
curl -X POST https://client-api.8slp.net/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"your_email","password":"your_password"}'
2. Add the user ID to your configuration as shown below.
Option 2: Using MCP Client
1. First set up your `.env` file without the user ID:EIGHT_SLEEP_EMAIL=your_email
EIGHT_SLEEP_PASSWORD=your_password
2. Run the MCP client once to get your user ID:node build/index.js getUsers
The response will include your user ID. Save this value.
3. Add the user ID to your configuration as shown below.
#### Environment Variables
Create a `.env` file:Eight Sleep Authentication
EIGHT_SLEEP_EMAIL=your_email
EIGHT_SLEEP_PASSWORD=your_password
EIGHT_SLEEP_USER_ID=your_user_id # Required: Add the userId from one of the methods above
EIGHT_SLEEP_CLIENT_ID=your_client_id
EIGHT_SLEEP_CLIENT_SECRET=your_client_secret
### Claude Desktop Integration
Add to Claude Desktop's config (Settings → Developer → Edit Config):{
"mcpServers": {
"eight_sleep": {
"command": "node",
"args": ["/absolute/path/to/eight-sleep-mcp/build/index.js"],
"env": {
"EIGHT_SLEEP_EMAIL": "your_email", // email and password not required once you have userid
"EIGHT_SLEEP_PASSWORD": "your_password", // email and password not required once you have userid
"EIGHT_SLEEP_USER_ID": "your_user_id",
"EIGHT_SLEEP_CLIENT_ID": "your_client_id", // optional
"EIGHT_SLEEP_CLIENT_SECRET": "your_client_secret" // optional
}
}
}
}
> **Important**: Adding your user ID to the configuration is required to avoid having to authenticate with email/password on every request. Make sure to get it using one of the methods above.
Restart Claude Desktop after saving.
## Available Functions
### User Information
- `getUsers` - Get user profile information
- `getUserPreferences` - Get user preferences (units, timezone, bed side)
- `updateUserPreferences` - Update user preferences
### Device Control
- `getDeviceStatus` - Get device status (online, firmware, water level)
- `setDevicePower` - Turn device on/off
- `getPresence` - Check if user is in bed
### Temperature Control
- `getTemperature` - Get current temperature settings
- `setTemperature` - Set immediate temperature (-100 to 100)
- `getTemperatureSchedules` - Get temperature schedules
- `setTemperatureSchedule` - Create temperature schedule
- `updateTemperatureSchedule` - Update temperature schedule
- `deleteTemperatureSchedule` - Delete temperature schedule
### Sleep Data
- `getSleepData` - Get detailed sleep data for date range
- `getSleepScore` - Get sleep score for a date
- `getSleepStages` - Get sleep stages (awake, light, deep, REM)
- `getHrv` - Get Heart Rate Variability data
- `getHeartRate` - Get heart rate data
- `getRespiratoryRate` - Get respiratory rate data
- `getSleepTiming` - Get bedtime and wake time
- `getSleepFitnessTrends` - Get sleep fitness trends
### Alarm Management
- `getAlarms` - Get all alarms
- `setAlarm` - Create new alarm
- `updateAlarm` - Update existing alarm
- `deleteAlarm` - Delete alarm
## Function Parameters
For date-based functions, use the format `YYYY-MM-DD`. For example:getSleepData({
startDate: "2024-03-15",
endDate: "2024-03-16" // optional
})
For temperature settings:setTemperature({
level: 50, // -100 to 100
duration: 3600 // seconds, optional
})
For alarms:setAlarm({
time: "07:00",
daysOfWeek: [1,2,3,4,5], // Mon-Fri
vibration: true,
sound: "chime" // optional
})
For temperature schedules:setTemperatureSchedule({
startTime: "22:00",
level: -20,
daysOfWeek: [0,1,2,3,4,5,6] // Every day
})
// Code blockSimilar MCP
Based on tags & features
Trending MCP
Most active this week