Sleepon

PyPI License: MIT

An MCP (Model Context Protocol) server that connects AI assistants like Claude to your Sleepon sleep tracker data. Ask your AI to analyze your sleep quality, compare nights, generate reports, and get personalized improvement tips — all powered by your real sleep data.

Features

• 🛏️ Daily Sleep Summary — sleep score, efficiency, duration, and stage breakdown
• 📊 Detailed Segments — per-segment heart rate, blood oxygen (SpO2), HRV, movement, and ODI
• 📅 Sleep Calendar — see which days have data over a date range
• 📈 Trend Analysis — track how your sleep metrics change over time
• 🏷️ Sleep Labels — view user-added tags (e.g. "exercised", "drank coffee") and notes
• 🤖 Built-in Prompts — one-click deep analysis, comparison, reports, and improvement tips

Quick Start

1. Install

# Using uvx (recommended, auto-downloads without install)
uvx sleepon-mcp

# Or install via pip
pip install sleepon-mcp

2. Configure Claude Desktop

To use this MCP server with Claude Desktop, you need to add it to your configuration file.

Step 1: Open the configuration file based on your operating system:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

(Tip: You can quickly open this from Claude Desktop: Menu -> Settings -> Developer -> Edit Config)

Step 2: Add the sleepon server to the mcpServers object. Replace the email and password with your actual Sleepon account credentials.

{
  "mcpServers": {
    "sleepon": {
      "command": "uvx",
      "args": ["sleepon-mcp"],
      "env": {
        "SLEEPON_USERNAME": "[email protected]",
        "SLEEPON_PASSWORD": "your-password"
      }
    }
  }
}

Note: uvx is recommended as it automatically manages the Python environment for you. If you prefer to use your system Python, you can use "command": "python", "args": ["-m", "sleepon_mcp.server"] instead.

⚠️ Troubleshooting: spawn uvx ENOENT Error If Claude Desktop shows an ENOENT error, it means it cannot find the uvx command in its system path. To fix this, you must provide the absolute path to uvx.

1. Open your terminal and run which uvx (Mac/Linux) or where uvx (Windows).
2. Copy the resulting path (e.g., /Users/username/.pyenv/shims/uvx or C:\\Users\\username\\.cargo\\bin\\uvx.exe).
3. Replace "uvx" in the "command" field of the config with this absolute path.

3. Restart Claude Desktop

1. Completely quit Claude Desktop (Cmd+Q on Mac, or right-click the system tray icon and exit on Windows).
2. Re-open Claude Desktop.
3. Look for the hammer icon (🔨) in the chat input area. Click on it to see the available Sleepon tools and prompts.

Available Tools

Built-in Prompts

These prompts guide the AI through multi-step analysis workflows:

Example Conversations

• "Analyze my sleep from last night"
• "Compare my sleep on Monday vs Friday"
• "Generate a sleep report for the past month"
• "How can I improve my sleep quality?"

Development

# Clone the repo
git clone https://github.com/sleepon-official/sleepon_mcp.git
cd sleepon_mcp

# Install in development mode
pip install -e .

# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector sleepon-mcp

Environment Variables

Requirements

• Python >= 3.10
• A Sleepon account with a paired sleep tracker

License

MIT