jprbom/-health-dashboard-mcp

Health Dashboard MCP Server

A powerful MCP (Model Context Protocol) server that enables AI assistants like Claude to interact with personal health and biometric data, providing intelligent insights and recommendations.

Features

• Biometric Recording: Track weight, blood pressure, heart rate, sleep, steps, glucose, and temperature
• Health Summaries: Get comprehensive health metric summaries for any time period
• Trend Analysis: AI-powered analysis of health trends with actionable insights
• Goal Setting: Set and track health goals with progress monitoring
• Smart Recommendations: Receive personalized health recommendations based on your data
• Wearable Integration: Support for Fitbit, Apple Watch, and Garmin devices (coming soon)

Installation

1. Clone this repository:

git clone https://github.com/[your-username]/health-dashboard-mcp.git
cd health-dashboard-mcp

2. Install dependencies:

npm install

3. Create a .env file for your API keys (optional, for wearable integrations):

FITBIT_CLIENT_ID=your_fitbit_client_id
FITBIT_CLIENT_SECRET=your_fitbit_client_secret
# Add other API keys as needed

Configuration

For Claude Desktop

Add to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "health-dashboard": {
      "command": "node",
      "args": ["C:/path/to/health-dashboard-mcp/src/index.js"]
    }
  }
}

Usage

Once configured, you can interact with your health data through Claude:

Recording Biometrics

• "Record my weight as 150 lbs"
• "Log my blood pressure: 120/80"
• "I slept for 7.5 hours last night, quality was good"

Viewing Summaries

• "Show me my health summary for the last week"
• "What were my average steps this month?"
• "Display my blood pressure trends"

Getting Insights

• "Analyze my weight trend over the last 30 days"
• "Are there any concerning patterns in my health data?"
• "How has my sleep quality affected my heart rate?"

Setting Goals

• "Set a goal to lose 10 pounds by March"
• "I want to average 10,000 steps per day"
• "Help me improve my sleep quality"

Available Tools

1. record_biometrics: Record various health metrics
2. get_health_summary: Retrieve health data summaries
3. analyze_trends: Analyze health metric trends
4. set_health_goals: Set and track health goals
5. get_recommendations: Get AI-powered health recommendations
6. generate_health_report: Generate comprehensive health reports
7. ai_health_coach: Interactive health coaching based on your data
8. predict_health_outcomes: Predict future health metrics based on trends

Privacy & Security

• All health data is stored locally on your machine
• No data is sent to external servers (except for optional wearable syncing)
• Sensitive information is excluded from git commits via .gitignore
• You maintain full control over your health data

Development

Project Structure

health-dashboard-mcp/
├── src/
│   ├── index.js            # Main server file
│   ├── tools/              # Individual tool implementations
│   ├── integrations/       # Wearable device integrations
│   └── utils/              # Utility functions
├── health_data/            # Local health data storage (gitignored)
├── .env                    # Environment variables (gitignored)
├── .gitignore              # Git ignore file
├── package.json            # Project dependencies
└── README.md               # This file

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Roadmap

• Full wearable device integration (Fitbit, Apple Watch, Garmin)
• Advanced visualization capabilities
• Export to common health data formats
• Integration with health apps and services
• Machine learning models for health predictions
• Medication tracking and reminders
• Nutrition tracking integration

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This tool is for personal health tracking and insights only. It is not a substitute for professional medical advice, diagnosis, or treatment. Always consult with qualified healthcare providers for medical concerns.

Support

For issues, questions, or suggestions, please open an issue on GitHub. "# -health-dashboard-mcp"