# Dexcom + Carb Search

A tool that helps people with diabetes make informed decisions by bringing together real-time glucose data and nutritional information.

## What This Does

This service connects to two essential data sources:

1. **Your Dexcom glucose monitor** - Retrieves your current blood glucose reading and trend information
2. **Nutritional search** - Finds carbohydrate content for foods you're considering eating

By combining these capabilities, it provides a clearer picture for managing blood sugar levels throughout the day.

## Who This Is For

This tool is designed for individuals managing diabetes who:
- Use Dexcom continuous glucose monitoring systems
- Want quick access to their glucose data alongside nutritional information
- Prefer having relevant health data available in one place

## How It Works

The service integrates with the Dexcom Share platform to access your glucose readings and uses web search to find carbohydrate information for specific foods. All data is retrieved on-demand when requested.

**Privacy Note**: Your Dexcom credentials are stored securely in your session configuration and are only used to authenticate with Dexcom's official servers.

## Setup Requirements

You'll need:
- An active Dexcom account with Share enabled
- A Bright Data API key for nutritional search functionality
- A Smithery account for deployment

## Getting Started

### Local Development

1. Start the development server:
   ```bash
   uv run dev
   ```

2. Test the tools interactively:
   ```bash
   uv run playground
   ```

### Configuration

The service requires four credentials:
- **Dexcom username** - Your Dexcom account email
- **Dexcom password** - Your Dexcom account password
- **Dexcom region** - Either "us" (United States) or "ous" (Outside US)
- **Bright Data API key** - For web search functionality

These can be configured either:
- Through Smithery session settings (recommended for deployment)
- As environment variables for local testing
- As parameters when calling the tools directly

## Available Capabilities

### Read Blood Glucose
Retrieves your most recent glucose reading from Dexcom, including:
- Current blood glucose level (mg/dL)
- Trend direction (rising, falling, steady)
- Timestamp of the reading

### Search Carbs
Finds carbohydrate information for specific foods by searching Google. Simply provide the food name, and the tool returns relevant nutritional data from multiple sources.

## Deployment

To make this service available through Smithery:

1. Create a GitHub repository:
   ```bash
   git init
   git add .
   git commit -m "Initial commit"
   git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
   git push -u origin main
   ```

2. Deploy to Smithery at [smithery.ai/new](https://smithery.ai/new)

3. Configure your Dexcom credentials and Bright Data API key in the Smithery session settings

## Technical Details

Built using:
- [Smithery CLI](https://smithery.ai/docs/getting_started/quickstart_build_python) for MCP server deployment
- Dexcom's official Python SDK ([pydexcom](https://github.com/gagebenne/pydexcom))
- Bright Data API for web search
- FastMCP framework for tool definitions

Server implementation: [bg_server.py](src/bg_server.py)

## Support

For issues or questions about this implementation, please file an issue in this repository.

For Dexcom-related questions, consult [Dexcom Support](https://www.dexcom.com/support).