dexcom-mcp

Dexcom CGM MCP Server

An MCP (Model Context Protocol) server that reads real-time continuous glucose monitor (CGM) data from Dexcom sensors via the Dexcom Share API. Integrates with Claude Desktop, allowing Claude to read your glucose levels, trends, and statistics directly.

Supports Dexcom One, G6, G7 — both EU and US regions.

---

Requirements

• Python 3.10+
• A Dexcom account with Share enabled in the mobile app
• An active CGM sensor

Installation

Option A — run directly from GitHub with uvx (no install needed)

uvx --from git+https://github.com/sobek34/dexcom-mcp.git dexcom-mcp

Option B — install with pip

pip install git+https://github.com/sobek34/dexcom-mcp.git
dexcom-mcp

Option C — clone and run locally

git clone https://github.com/sobek34/dexcom-mcp.git
cd dexcom-mcp
pip install -r requirements.txt
python server.py

---

Configuration

Set these environment variables before running:

| Variable | Description | Default | |--------------------|------------------------------------------|------------| | DEXCOM_USERNAME | Dexcom account email / login | required | | DEXCOM_PASSWORD | Dexcom account password | required | | DEXCOM_REGION | EU (Europe) or US | EU |

Note: Dexcom One uses the EU server (shareous1.dexcom.com). Dexcom G6/G7 in the US uses the US server (share2.dexcom.com).

---

Claude Desktop Integration

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

With uvx (recommended — always uses latest version)

{
  "mcpServers": {
    "dexcom-cgm": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/sobek34/dexcom-mcp.git", "dexcom-mcp"],
      "env": {
        "DEXCOM_USERNAME": "your@email.com",
        "DEXCOM_PASSWORD": "your_password",
        "DEXCOM_REGION": "EU"
      }
    }
  }
}

With a local clone

{
  "mcpServers": {
    "dexcom-cgm": {
      "command": "python",
      "args": ["/path/to/dexcom-mcp/server.py"],
      "env": {
        "DEXCOM_USERNAME": "your@email.com",
        "DEXCOM_PASSWORD": "your_password",
        "DEXCOM_REGION": "EU"
      }
    }
  }
}

---

Available MCP Tools

get_current_glucose

Returns the latest glucose reading, trend arrow, and status.

Parameters:

• unit — "mmol/L" (default) or "mg/dL"

Example output: `` Glucose: 5.8 mmol/L → Trend: stable Status: IN RANGE Reading time: 14:35 UTC ``

---

get_glucose_history

Returns readings for the last X hours (up to 24h), one every 5 minutes.

Parameters:

• hours — 1–24 (default: 3)
• unit — "mmol/L" or "mg/dL"

---

get_glucose_stats

Calculates statistics over a time window.

Parameters:

• hours — 1–24 (default: 24)
• low_threshold — lower TIR boundary in mmol/L (default: 3.9)
• high_threshold — upper TIR boundary in mmol/L (default: 10.0)

Returns: mean, standard deviation, CV, TIR / TBR / TAR, estimated HbA1c (ADAG formula)

---

check_alerts

Lists hypoglycemia and hyperglycemia events within a time window.

Parameters:

• hours — 1–24 (default: 24)
• low_alert — hypo threshold in mmol/L (default: 3.9)
• high_alert — hyper threshold in mmol/L (default: 10.0)

---

How to Enable Dexcom Share

1. Open the Dexcom app (One / G6 / G7) on your phone
2. Go to Settings → Share and enable sharing
3. You do not need to add a follower — just enabling Share is enough

---

Security

• Never hardcode credentials — always use environment variables
• This uses an unofficial, undocumented API — it may break after Dexcom app updates

Disclaimer

This project is not affiliated with, endorsed by, or supported by Dexcom, Inc. Use at your own risk. Do not make medical decisions based solely on data returned by this tool.