🩸 Nightscout MCP Server

Connect your Nightscout CGM data to any AI assistant via the Model Context Protocol.
Real-time glucose · Treatments · Statistics · Pattern detection · Analytics · i18n

Quick Start • Tools • Configuration • i18n • Українською

What is this?

Nightscout MCP is a Model Context Protocol server that bridges your Nightscout CGM instance with AI assistants. Ask questions about your glucose data in natural language — the AI gets structured access to your readings, treatments, profiles, statistics, and pattern analysis.

“What’s my TIR for the past week?”
“How did that pizza affect my glucose?”
“Detect patterns in my overnight readings”
“Compare training days vs rest days”

Works with any MCP-compatible client.

⚡ Quick Start

# 1. Clone and install
git clone https://github.com/adminpb/Nightscout-MCP.git
cd Nightscout-MCP
npm install

# 2. Build
npm run build

# 3. Configure your MCP client (see below)

MCP Client Configuration

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "nightscout": {
      "command": "node",
      "args": ["C:\\Magic\\Nightscout-MCP\\dist\\index.js"],
      "env": {
        "NIGHTSCOUT_URL": "https://your-nightscout.example.com",
        "NIGHTSCOUT_TOKEN": "your-read-token",
        "NIGHTSCOUT_UNITS": "mmol/L",
        "NIGHTSCOUT_LOCALE": "en"
      }
    }
  }
}

🔧 Tools

Reading Data

Analytics

Writing Data

Write tools require NIGHTSCOUT_READONLY=false.

📋 Prompts

Pre-built prompt templates for common workflows:

📦 Resources

⚙️ Configuration

* Either NIGHTSCOUT_TOKEN or NIGHTSCOUT_API_SECRET is required.

🌍 Localization

Nightscout MCP supports multiple languages. All tool names and MCP interface remain in English for compatibility. Locale affects status labels, messages, and report strings in tool responses.

Adding a new locale: create a translation object in src/i18n/index.ts following the TranslationStrings interface. PRs welcome!

🔒 Security

• Tokens never reach the AI — only processed data is returned via MCP
• Read-only by default — write operations require explicit opt-in
• Input validation — all parameters validated with Zod schemas
• SHA1 hashing — API secrets are hashed before transmission

🛠 Development

npm run dev      # TypeScript watch mode
npm run build    # Production build
npm start        # Run the server

Project Structure

src/
├── index.ts              # MCP server — tools, resources, prompts
├── config.ts             # Environment variable configuration
├── client.ts             # Nightscout REST API v1 client
├── i18n/
│   └── index.ts          # Internationalization (en, uk)
└── tools/
    ├── get_current_glucose.ts
    ├── get_glucose_history.ts
    ├── get_statistics.ts
    ├── get_treatments.ts
    ├── get_profile.ts
    ├── get_device_status.ts
    ├── get_daily_report.ts
    ├── detect_patterns.ts
    ├── compare_periods.ts
    ├── analyze_meal.ts
    ├── overnight_analysis.ts
    ├── find_events.ts
    ├── glucose_at_time.ts
    ├── a1c_estimator.ts
    ├── export_csv.ts
    ├── weekly_comparison.ts
    ├── insulin_sensitivity_check.ts
    ├── carb_ratio_check.ts
    ├── compression_low_analysis.ts
    ├── add_treatment.ts
    └── add_note.ts

📊 Example Queries

Once connected, you can ask your AI assistant:

"What's my glucose right now?"
"Show my TIR for the past 7 days"
"Analyze how coffee with kefir spiked my glucose"
"Give me a daily report for yesterday"
"What were my lows this week?"
"Do I have a dawn phenomenon?"
"Detect patterns in my last 14 days"
"Compare my glucose on workout days vs rest days"
"Are my basal rates set correctly based on overnight patterns?"
"Is my ISF accurate? Check correction bolus data"
"Am I bolusing enough for meals? Check my carb ratios"
"How am I doing this week compared to last?"
"Are my nighttime lows real or compression artifacts?"
"Estimate my HbA1c for my lab appointment on March 16"
"Export my last 2 weeks as CSV for my doctor"
"Log 45g carbs and 4U insulin for lunch"

Roadmap

• Core tools: glucose, treatments, statistics, profiles, device status
• Daily reports with notable events
• Localization (EN / UK)
• detect_patterns `detect_patterns` — overnight lows, dawn phenomenon, post-meal spikes, variability
• add_treatment / add_note `add_treatment` / `add_note` — write operations
• compare_periods `compare_periods` — side-by-side period comparison
• analyze_meal / overnight_analysis `analyze_meal` / `overnight_analysis` — deep analytics
• find_events / glucose_at_time `find_events` / `glucose_at_time` — search and lookup
• a1c_estimator `a1c_estimator` — future HbA1c projection
• export_csv `export_csv` — data export for doctors
• API response caching with TTL
• weekly_comparison `weekly_comparison` — auto this-week vs last-week
• insulin_sensitivity_check `insulin_sensitivity_check` — real ISF from correction data
• carb_ratio_check `carb_ratio_check` — real ICR from meal data
• compression_low_analysis `compression_low_analysis` — false low detection
• npm package publishing
• Docker image
• More locales (ES, DE, PL, ...)

📄 License

GPL v3 with additional terms under Section 7:

• Attribution required — original author adminpb <adminpb@ukr.net> must be credited in all copies and derivatives
• 🇷🇺 Russia restriction — use of this software within the Russian Federation, by RF citizens, or by RF-registered entities is expressly prohibited

Free and open source for everyone else. See LICENSE for full details.

git clone https://github.com/adminpb/Nightscout-MCP.git
cd Nightscout-MCP
npm install
npm run build

{
  "mcpServers": {
    "nightscout": {
      "command": "node",
      "args": ["C:\\Magic\\Nightscout-MCP\\dist\\index.js"],
      "env": {
        "NIGHTSCOUT_URL": "https://ваш-nightscout.example.com",
        "NIGHTSCOUT_TOKEN": "ваш-токен",
        "NIGHTSCOUT_UNITS": "mmol/L",
        "NIGHTSCOUT_LOCALE": "uk"
      }
    }
  }
}

🇺🇦 Made in Ukraine for the civilized world.
_{Orcs don't qualify as civilized. Deal with it. 🧌🚫}