Sleep Calculator

Calculators REST API MCP

Calculate the best bedtimes for a wake-up time, or the best wake-up times for a bedtime, based on 90-minute sleep cycles plus 15 minutes to fall asleep. Returns 4 options (3-7 cycles) with duration and quality (optimal/good/fair).

This page documents the MCP tool findutils:sleep_calculator. See the REST reference →

Call it over MCP

Tool name findutils:sleep_calculator · no API keys · 120 requests/min per IP

Claude Code

claude mcp add findutils --transport http https://mcp.findutils.com/

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

Raw JSON-RPC (any MCP client) — verified example

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "sleep_calculator",
      "arguments": {
        "mode": "wake",
        "time": "07:00"
      }
    }
  }'

Input schema

Argument Type Required Description
mode string (wake | sleep | now) no "wake": you give the wake-up time and get bedtimes (6 down to 3 cycles). "sleep": you give the bedtime and get wake-up times (4 to 7 cycles). "now": like "sleep" with the current time (UTC) when time is omitted. Default: "wake".
time string no Time of day as HH:MM (24-hour). Required for "wake" and "sleep". Optional for "now".

Example arguments (verified)

{
  "mode": "wake",
  "time": "07:00"
}

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/sleep-calculator/execute — no key, 60 requests/min.

Open the REST reference for Sleep Calculator →

More Calculators tools