8sleep MCP

🚀 Eight Sleep MCP

A Model Context Protocol (MCP) server for accessing Eight Sleep pillow data.

🚀 Quick Start

📦 Installation

Prerequisites

• Node.js (v16+)
• An Eight Sleep account

Installation Steps

1. Clone the repository.
2. Run the following commands:

npm install
npm run build

Configuration Guide

Obtain Your User ID

You need to obtain your Eight Sleep user ID once and add it to the configuration. This prevents the client from having to authenticate via email/password on every request. You have two options:

Option 1: Direct API Call

1. Use the following curl command:

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 the configuration as shown below.

Option 2: Use the MCP Client

1. First, set up the .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 contain your user ID. Save this value. 3. Add the user ID to the 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: Obtain the user ID using one of the methods above
EIGHT_SLEEP_CLIENT_ID=your_client_id
EIGHT_SLEEP_CLIENT_SECRET=your_client_secret

Integrate with Claude Desktop

Add the following configuration to Claude Desktop (Settings → Developer → Edit Configuration):

{
    "mcpServers": {
        "eight_sleep": {
            "command": "node",
            "args": ["/absolute/path/to/eight-sleep-mcp/build/index.js"],
            "env": {
                "EIGHT_SLEEP_EMAIL": "your_email", // Email and password are not required once you have the user ID
                "EIGHT_SLEEP_PASSWORD": "your_password", // Email and password are not required once you have the user ID
                "EIGHT_SLEEP_USER_ID": "your_user_id",
                "EIGHT_SLEEP_CLIENT_ID": "your_client_id", // Optional
                "EIGHT_SLEEP_CLIENT_SECRET": "your_client_secret" // Optional
            }
        }
    }
}

⚠️ Important Note

Adding the user ID to the configuration is required to avoid email/password authentication on every request. Make sure to obtain the user ID using one of the methods above.

Restart Claude Desktop after saving the configuration.

✨ Features

User Information

• getUsers - Get user profile information.
• getUserPreferences - Get user preference settings (units, timezone, bed side).
• updateUserPreferences - Update user preference settings.

Device Control

• getDeviceStatus - Get device status (online, firmware version, water level).
• setDevicePower - Turn the device off/on.
• getPresence - Check if the user is in bed.

Temperature Control

• getTemperature - Get the current temperature setting.
• setTemperature - Set the immediate temperature (-100 to 100).
• getTemperatureSchedules - Get temperature schedules.
• setTemperatureSchedule - Create a temperature schedule.
• updateTemperatureSchedule - Update a temperature schedule.
• deleteTemperatureSchedule - Delete a temperature schedule.

Sleep Data

• getSleepData - Get detailed sleep data within a date range.
• getSleepScore - Get the sleep score for a specific day.
• getSleepStages - Get sleep stages (awake, light, deep, REM).
• getHrv - Get heart rate variability data.
• getHeartRate - Get heart rate data.
• getRespiratoryRate - Get respiratory rate data.
• getSleepPosition - Get sleep position.

💻 Usage Examples

Basic Usage

setTemperatureSchedule({
  startTime: "22:00",
  level: -20,
  daysOfWeek: [0,1,2,3,4,5,6]  // Every day
})