Nightscout MCP Server

Access your CGM data from Nightscout in AI assistants like Claude, Cursor, etc.

Quick Start

uvx --from git+https://github.com/vgmakeev/nightscout-mcp nightscout-mcp

Setup

Add to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "nightscout": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/vgmakeev/nightscout-mcp", "nightscout-mcp"],
      "env": {
        "NIGHTSCOUT_URL": "https://YOUR_TOKEN@your-site.nightscout.com"
      }
    }
  }
}

Configuration

| Variable | Description | Default | |----------|-------------|---------| | NIGHTSCOUT_URL | Nightscout URL (can include token: https://token@site.com) | Required | | NIGHTSCOUT_API_SECRET | API secret (optional if using token in URL) | - | | GLUCOSE_UNITS | Display units: mmol or mgdl | mmol | | GLUCOSE_LOW | TIR lower bound (auto-detects units: <30 = mmol) | 3.9 (70 mg/dL) | | GLUCOSE_HIGH | TIR upper bound (auto-detects units: <30 = mmol) | 7.8 (140 mg/dL) |

Example with custom TIR range

{
  "nightscout": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/vgmakeev/nightscout-mcp", "nightscout-mcp"],
    "env": {
      "NIGHTSCOUT_URL": "https://TOKEN@your-site.nightscout.com",
      "GLUCOSE_UNITS": "mmol",
      "GLUCOSE_LOW": "4.0",
      "GLUCOSE_HIGH": "10.0"
    }
  }
}

Tools

| Tool | Description | |------|-------------| | glucose_current | Current glucose reading | | glucose_history | History for last N hours | | analyze | TIR, CV, HbA1c for any date range | | analyze_monthly | Monthly breakdown for a year | | treatments | Insulin and carbs log | | status | Nightscout server status | | devices | Pump, CGM, uploader status |

Examples

Ask your AI assistant:

"What's my current glucose?"
"Show my glucose history for the last 6 hours"
"Analyze my glucose control for December 2025"
"Give me a monthly breakdown for 2025"

License

MIT

nightscout-mcp