Which integrations are available for this server?

Provides a ready Fitbit provider integration (requiring OAuth2 credentials) for accessing wellness data such as sleep, activity, heart rate, steps, and stress through MCP tools for current vitals, history, and trend analysis.

How do I use MCP Wellness Agent?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Wellness Agent how did I sleep last night and what's my resting heart rate?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Wellness Agent

License: MIT Python 3.10+ MCP

A Model Context Protocol (MCP) server that exposes wellness data (sleep, activity, heart rate) as tools for AI agents. Built for the Amazon Build Ship Shape 2026 hackathon as part of the Open Source Mini-Challenge.

🌟 Features

MCP Protocol: Implements the Model Context Protocol for agent-tool communication
Multi-Provider: Supports Fitbit, Apple Health, and realistic simulation
A2A Compatible: Includes agent card for agent-to-agent discovery
Voice-Ready: Optimized for Alexa+ and voice-first interfaces
Type-Safe: Full Pydantic models for all data
Extensible: Easy to add new wellness providers

Related MCP server: vitals

🚀 Quick Start

# Install
pip install mcp-wellness-agent

# Run MCP server
mcp-wellness-server --transport streamable-http --port 8001

# Or use as library
from mcp_wellness_agent import WellnessServer
server = WellnessServer(provider="fitbit")

📡 MCP Tools

`get_vitals(user_id: str)`

Get current wellness vitals for a user.

Returns:

sleep_hours: Hours of sleep
sleep_quality: Quality score (1-10)
activity_level: low/normal/high
heart_rate_avg: Resting heart rate
steps: Daily step count
stress_level: Stress score (1-10)

`get_history(user_id: str, days: int)`

Get historical wellness data.

`analyze_trends(user_id: str)`

Get trend analysis and insights.

🔌 Providers

Provider	Status	Notes
Simulated	✅ Ready	Realistic physiological simulation
Fitbit	✅ Ready	Requires OAuth2 credentials
Apple Health	🚧 Planned	macOS/iOS only
Garmin	🚧 Planned	Coming soon

🏗️ Architecture

┌─────────────────┐     MCP      ┌──────────────────┐
│   AI Agent      │◄────────────►│  Wellness Agent  │
│  (Claude, etc)  │  Streamable  │   MCP Server     │
└─────────────────┘   HTTP       └──────────────────┘
                                            │
                              ┌─────────────┼─────────────┐
                              ▼             ▼             ▼
                         ┌────────┐   ┌─────────┐   ┌──────────┐
                         │ Fitbit │   │ Apple   │   │ Simulated│
                         │  API   │   │ Health  │   │ Engine   │
                         └────────┘   └─────────┘   └──────────┘

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

📄 License

Dual-Licensed under GNU AGPLv3 (AGPL-3.0-only) and PolyForm Noncommercial 1.0.0 — No closed-source or commercial use is permitted without prior written permission (see LICENSE, LICENSE.NONCOMMERCIAL.md, and COMMERCIAL_LICENSE.md).

🏆 Hackathon

Built for Amazon Build Ship Shape 2026 - Open Source Mini-Challenge.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

Wellness Project AOAuth
ai.wellnessproject
Connect your health, fitness, nutrition, sleep, and wearable data to your AI assistant.
AI & Machine Learning Fitness Tracking Health & Wellness
8222
https://wellnessproject.ai/api/mcp
Withings Health DataOAuth
io.github.akutishevsky
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Health & Wellness Research & Data
245
https://withings-mcp.com/mcp
freddyOAuth
coach.freddy
Connect your wearables, rings and training apps, then ask your AI about your own health data.
Health & Wellness Fitness Tracking
2
https://freddy.coach/mcp
Vital MCP by usefulapi A
io.usefulapi
Read wearables and lab health data — sleep, activity, workouts, timeseries, lab tests and orders.
Health & Wellness Biology & Medicine Fitness Tracking
212
https://vital.usefulapi.io/mcp

Related MCP Servers

health-mcp
Health & Wellness Fitness Tracking
jonathan249
A
license
Not graded
quality
D
maintenance
Exposes personal Garmin wellness data through MCP tools for accessing summary, sleep, HRV, heart rate, stress, body battery, and historical data.
Updated 5 months ago (2026-06-12 18:45 UTC)
MIT
vitals
Health & Wellness Fitness Tracking
DocStream-Oficial
A
license
Not graded
quality
B
maintenance
Exposes personal health data (recovery, sleep, strain, etc.) as MCP tools for AI agents to query and analyze.
Updated a month ago (2026-09-28 05:45 UTC)
5
MIT
helm-personal-os
Project Management Health & Wellness Calendar Management
joelpfrank
A
license
Not graded
quality
C
maintenance
Provides MCP tools to read and update a local-first personal OS for goals, tasks, habits, food, workouts, and check-ins. Enables assistants to manage daily life data and interact with an evidence-grounded AI coach.
Updated 7 days ago (2026-10-21 01:37 UTC)
MIT
Sapphire Wellness MCP Server
Health & Wellness Fitness Tracking
IBMC-WORK-REDESIGN-FDE-COHORT-MC
F
license
Not graded
quality
C
maintenance
Exposes health metrics from the Sapphire Wellness App to AI assistants via MCP, enabling queries on activity, blood pressure, glucose, heart rate, sleep, and SpO2 data.
Updated 3 months ago (2026-08-07 12:46 UTC)
-

MCP Wellness Agent

🌟 Features

🚀 Quick Start

📡 MCP Tools

get_vitals(user_id: str)

get_history(user_id: str, days: int)

analyze_trends(user_id: str)