MCP Glucose Server

A Model Context Protocol (MCP) server that provides glucose data query tools to AI assistants like Claude and ChatGPT. Connects to the health-data-storage API to retrieve glucose readings.

🎯 Purpose

This MCP server acts as a specialized interface between AI assistants and your glucose data. It provides natural language tools for querying glucose levels, trends, and statistics.

🏗️ Architecture Position

🔧 Available Tools

1. get_glucose_readings

Get glucose readings within a date range.

Parameters:

• userId (optional): User identifier (defaults to USER_ID env var)

• startDate (optional): Start date in ISO 8601 format

• endDate (optional): End date in ISO 8601 format

• limit (optional): Maximum number of readings (default: 1000)

Example queries:

• "What's my glucose been like today?"

• "Show me my glucose readings for the past week"

• "Get my glucose levels from October 1st to October 22nd"

2. get_latest_glucose

Get the most recent glucose reading.

Parameters:

• userId (optional): User identifier (defaults to USER_ID env var)

Example queries:

• "What's my current glucose?"

• "What was my last glucose reading?"

• "Check my latest blood sugar"

3. get_glucose_stats

Get glucose statistics (count, average, min, max) for a time period.

Parameters:

• userId (optional): User identifier (defaults to USER_ID env var)

• startDate (optional): Start date in ISO 8601 format

• endDate (optional): End date in ISO 8601 format

Example queries:

• "What's my average glucose this week?"

• "Show me my glucose stats for the past month"

• "What was my glucose range yesterday?"

🚀 Setup

Prerequisites

• Node.js 20+

• Access to a deployed health-data-storage instance

• API secret for authentication

Installation

Configuration

Create a .env file (or set environment variables):

Usage with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

Restart Claude Desktop.

Usage with ChatGPT

(ChatGPT MCP support coming soon)

💬 Example Conversations

Once configured, you can ask Claude:

Simple queries:

"What's my latest glucose?"

Time range queries:

"Show me my glucose for the past 24 hours"

Statistical queries:

"What's my average glucose this week?"

Analysis queries:

"Analyze my glucose patterns over the last month"

Claude will use the tools to fetch data and provide intelligent analysis of your glucose trends, patterns, and insights.

🔗 Related Projects

• health-data-storage: Storage backend that this server queries

• health-tracking-app: iOS app that collects the glucose data

• mcp-activity: (future) MCP server for activity/exercise data

• mcp-nutrition: (future) MCP server for food/nutrition data

📈 Future Enhancements

Potential additions:

• Trend analysis tools: Detect glucose spikes, patterns

• Correlation tools: Compare glucose with meals, exercise

• Alert tools: Notify when glucose is out of range

• Export tools: Generate reports, charts

• Multi-user support: Query data for multiple users

🛠️ Development

Local Testing

The server runs on stdio (standard input/output) as per MCP specification. Use it with Claude Desktop or the MCP inspector for testing.

Testing with MCP Inspector

📝 License

MIT