sleepon-mcp 0.1.0

MCP server for Sleepon sleep tracker – provides sleep data analysis tools for AI assistants like Claude

Sleepon MCP Server

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

Add the following to your Claude Desktop configuration file:

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

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

3. Restart Claude Desktop

After saving the config, restart Claude Desktop. You'll see the Sleepon tools available in the MCP tools menu (🔨 icon).

---

Available Tools

Tool	Description
login_and_check_status	Verify that your credentials are correct and the API is reachable
get_user_profile	Get your Sleepon user profile information
get_daily_sleep_summary	Get complete sleep summary for a specific date
get_detailed_sleep_segments	Get detailed segment data (heart rate, SpO2, HRV, sleep stages)
get_sleep_calendar	View which days have data in a date range
get_sleep_trend	Get sleep metric trends over a date range
get_sleep_labels	Get user-added sleep labels and notes for a date
get_latest_data_time	Find the most recent data sync timestamp

Built-in Prompts

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

Prompt	Description
analyze_sleep	Comprehensive analysis of a single night (summary + segments + labels)
compare_sleep	Side-by-side comparison of two nights with tables
sleep_report	Full report for a date range (trends, best/worst days, health alerts)
sleep_improvement_tips	Personalized recommendations based on your recent data

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

Variable	Required	Description
SLEEPON_USERNAME	Yes	Your Sleepon account email
SLEEPON_PASSWORD	Yes	Your Sleepon account password

Requirements

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

License

MIT