Dexcom G7 MCP Server

A Model Context Protocol (MCP) server that provides access to Dexcom G7 continuous glucose monitor data. This server allows AI assistants and other MCP clients to retrieve current glucose readings and historical data from your Dexcom G7 device.

Features

• Current Glucose Reading: Get the latest glucose value with trend information
• Historical Data: Retrieve glucose readings for a specified time period
• Dual Units: Values provided in both mg/dL and mmol/L
• HTTP Transport: Native HTTP/JSON-RPC interface for easy integration
• MCP Compatible: Full Model Context Protocol compliance

Quick Start

Using Docker

# Build the image
docker build -t dexcom-mcp .

# Run with your credentials
docker run -p 8007:8007 \
  -e DEXCOM_USERNAME="your-dexcom-username" \
  -e DEXCOM_PASSWORD="your-dexcom-password" \
  -e DEXCOM_REGION="us" \
  dexcom-mcp

Using MCP-Compose

For orchestrated deployment with other MCP servers, use mcp-compose:

# mcp-compose.yaml
version: '1'
servers:
  dexcom:
    image: dexcom-mcp:local
    runtime: docker
    build:
      context: .
      dockerfile: Dockerfile
    protocol: http
    http_port: 8007
    env:
      HTTP_PORT: "8007"
      DEXCOM_REGION: "us"
      DEXCOM_USERNAME: "your-dexcom-username"
      DEXCOM_PASSWORD: "your-dexcom-password"
    capabilities: [tools]
    networks: [mcp-net]

Then start with:

mcp-compose up dexcom

Environment Variables

Note: For users outside the US, set DEXCOM_REGION=ous (Outside US).

Available Tools

get_current_glucose

Retrieves the most recent glucose reading from your Dexcom G7.

Parameters: None

Example Response:

🩸 Current Glucose: 120 mg/dL (6.66 mmol/L)
📈 Trend: Steady
⏰ Time: 2024-01-15 14:30:00

get_glucose_history

Retrieves historical glucose readings for a specified time period.

Parameters:

• hours (integer, optional): Number of hours of history to retrieve (default: 6)

Example Response:

📊 Last 6h glucose readings:
1. 2024-01-15 14:30:00 - 120 mg/dL (6.66 mmol/L) [Steady]
2. 2024-01-15 14:25:00 - 118 mg/dL (6.55 mmol/L) [Steady]
3. 2024-01-15 14:20:00 - 115 mg/dL (6.39 mmol/L) [Slowly Rising]
...

API Usage

Initialize Connection

curl -X POST http://localhost:8007/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

Get Current Glucose

curl -X POST http://localhost:8007/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_current_glucose",
      "arguments": {}
    }
  }'

Get Glucose History

curl -X POST http://localhost:8007/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_glucose_history",
      "arguments": {"hours": 12}
    }
  }'

Client Integration

Claude Desktop

Add to your Claude Desktop MCP settings:

{
  "servers": [
    {
      "name": "dexcom",
      "httpEndpoint": "http://localhost:8007",
      "capabilities": ["tools"],
      "description": "Dexcom G7 glucose monitor"
    }
  ]
}

OpenWebUI

Use the auto-generated OpenAPI specification at http://localhost:8007/openapi.json (when using mcp-compose proxy).

Architecture

... View full README on GitHub