← Back to Skills Marketplace
kentsteffen

BestYou Health Intelligence

by kentsteffen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
137
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install bestyou
Description
Connect your AI agent to BestYou health intelligence via MCP. 19 on-device AI agents coordinate fitness, nutrition, sleep, and recovery into an adaptive dail...
README (SKILL.md)

BestYou Health Intelligence

BestYou brings real health data from your wearables into your AI agent through MCP. It pulls fitness, nutrition, sleep, and recovery signals from Apple Watch, Oura Ring, CGM sensors, and HealthKit, then coordinates them through 19 specialized on-device agents. The result is an adaptive daily action plan that responds to your actual readiness, not generic templates. Query your readiness score, generate workouts matched to your recovery state, analyze meals against your macro targets, and manage your plan through natural conversation.

Privacy note: No health data leaves your device without your explicit consent. BestYou shares processed insights only. Raw HealthKit readings stay on the iPhone. See references/security.md for details.

What Makes This Different

Most health integrations export static data or generate generic prompts. BestYou connects to a live API backed by 19 coordinated AI agents running on-device.

  • Cross-domain coordination. Sleep quality affects training intensity, which affects nutritional needs, which affects recovery. BestYou's agents talk to each other. A bad night of sleep triggers adjustments across your workout, nutrition targets, and recovery priorities automatically.
  • Real wearable data, not manual logging. Heart rate, HRV, sleep stages, activity rings, glucose trends: all pulled from HealthKit. No typing in numbers.
  • Adaptive action plans. Your daily plan is built from your actual readiness, schedule, and recovery state. It adapts as conditions change.
  • 19 specialized agents. Each health domain (sleep, cardiac, nutrition, fitness, stress, hydration, body composition, and more) has a dedicated agent. They coordinate through a readiness engine that produces a single, actionable plan.
  • Metabolic health aware. Tracks glucose patterns, metabolic flexibility indicators, and coordinates nutrition with training for metabolic optimization. Supports GLP-1 users with protein safety floors and resistance training compliance.

Setup

1. Get your API key

Open the BestYou iOS app: More → Connected Apps → OpenClaw → Generate Key

Your key looks like by_mcp_live_.... Full walkthrough: bestyou.ai/openclaw-setup

2. Set the environment variable

export BESTYOU_API_KEY="YOUR_KEY_HERE"

3. Connect via mcporter

If you don't have mcporter (OpenClaw's MCP client) installed yet, you can install it with:

npm install -g mcporter

Add BestYou as an MCP server:

mcporter config add bestyou \
  --url https://mcp.bestyou.ai/mcp \
  --header "Authorization: Bearer $BESTYOU_API_KEY"

Verify with mcporter call bestyou.get_account_link_status.

For a more detailed setup walkthrough, see references/setup.md.


Agent Behavior

Session Start

Always call get_account_link_status first. If the account is not linked or the subscription is inactive, tell the user what to fix (re-link in BestYou app, check subscription) and stop. Do not call other tools until status is confirmed.

Daily Coaching Flow

  1. Call get_daily_briefing with today's date to pull the narrative, readiness score, and recommended actions.
  2. Summarize in 2-3 sentences: how the user is doing, what stands out.
  3. Recommend 1-2 concrete actions from the briefing.

Plan Management

  • Call get_todays_action_plan to see scheduled blocks (workouts, meals, recovery) for the day.
  • Present blocks grouped by time period (morning, afternoon, evening).
  • When the user asks about adjustments, show them what's on the plan and help them prioritize.

Fitness

  • generate_workout: Ask for type (strength, mobility, cardio, mixed, hiit), duration, available equipment, and experience level before generating. Optional: body parts, target areas, goal, injuries, warmup/cooldown preferences.

Nutrition

  • analyze_meal_text: Accept a text description of what the user ate. Optionally include a timestamp. Returns macro breakdown, components, and insights on how the meal fits the day's targets.

Progress and Trends

  • get_progress_snapshot: Shows domain-level scores (sleep, cardiac, fitness, nutrition, hydration, glucose, etc.), top insights, recommendations, and cross-domain patterns.
  • get_weekly_summary: End-of-week review with trends, achievements, and next week focus areas.

Style

Direct, calm, practical. You're a coach, not a cheerleader. State what matters, skip the filler.

Safety

  • Never expose internal IDs, suggestion IDs, session IDs, tokens, or raw auth values in responses.
  • Never share raw health data outside the conversation. Only surface processed insights.
  • If a tool returns an error, explain the issue plainly without leaking technical details.

Tool Reference

Tool When to use Required parameters
get_account_link_status First call every session. Confirms link, subscription, scopes. (none)
get_daily_briefing User asks "how am I doing today?" or starts a health conversation. date (YYYY-MM-DD)
get_todays_action_plan User wants to see today's plan or scheduled blocks. date (optional)
get_progress_snapshot User asks "how am I doing overall?" or wants domain scores. date (YYYY-MM-DD)
get_weekly_summary End-of-week review or "how was my week?" weekEndDate (optional)
generate_workout User wants a new workout built from scratch. type, duration, equipment, experienceLevel
analyze_meal_text User describes food they ate for nutritional analysis. description

generate_workout parameters

Required: type (strength/mobility/cardio/mixed/hiit), duration (minutes), equipment (array of strings), experienceLevel (Beginner/Intermediate/Advanced)

Optional: bodyParts, targetAreas, goal, injuries, includeWarmup, warmupStyle (dynamic/activation), warmupDuration, includeCooldown, cooldownStyle (static/foam_rolling/combined), cooldownDuration


Example Conversations

Morning check-in

User: "What's my day look like?"

Agent: Call get_account_link_status, then get_daily_briefing with today's date. Summarize readiness, highlight top priorities, suggest 1-2 actions.

Logging a meal

User: "Just had a chicken burrito bowl with brown rice and guac"

Agent: Call analyze_meal_text with description="chicken burrito bowl with brown rice and guacamole". Report macros and how it fits the day's targets.

Progress check

User: "How am I doing overall?"

Agent: Call get_progress_snapshot with today's date. Highlight strongest and weakest domains, surface top recommendation.

Weekly review

User: "How was my week?"

Agent: Call get_weekly_summary. Highlight trends (improving/declining domains), top achievement, and next week's focus areas.

Quick workout

User: "Give me a 20-minute bodyweight workout focused on strength"

Agent: Call generate_workout with type="strength", duration=20, equipment=["bodyweight"], experienceLevel="Intermediate". Present the workout clearly with exercises, sets, reps, and rest periods.


Notes

  • API key source: Generated in the BestYou iOS app, not a web dashboard.
  • Free trial: Use code OPENCLAW1MO for one free month of BestYou Pro.
  • Privacy: BestYou shares processed insights only. Raw health data (HealthKit, sensor data) never leaves the device. No data is stored locally by this skill.
  • Playground: Test your connection at mcp.bestyou.ai/openclaw before wiring into your agent.
Usage Guidance
This skill appears coherent and implements a straightforward MCP integration. Before installing, confirm the domain (mcp.bestyou.ai) is the official BestYou endpoint and generate a revocable key in the app. Prefer storing the key in a secure secrets manager rather than a shell profile or plaintext config file; if you must store it in mcporter's config, understand it will be saved locally in that file. Be aware the setup asks you to restart the OpenClaw gateway and to install mcporter via npm. If you have concerns about local token storage, rotate/revoke the key after testing and review the BestYou app's revocation controls.
Capability Analysis
Type: OpenClaw Skill Name: bestyou Version: 1.0.0 The 'bestyou' skill is a legitimate health intelligence integration that connects an AI agent to the BestYou platform via the Model Context Protocol (MCP). It facilitates fitness tracking, meal analysis, and workout generation using tools like `get_daily_briefing` and `generate_workout`. The skill includes explicit safety instructions in SKILL.md to prevent the leakage of sensitive tokens or raw health data, and its network activity is restricted to the official mcp.bestyou.ai endpoint as documented in references/security.md.
Capability Assessment
Purpose & Capability
Name and description match the required artifacts: a BestYou API key and an MCP client (mcporter) to talk to https://mcp.bestyou.ai/mcp. The single required env var (BESTYOU_API_KEY) is exactly the credential you would expect for this integration.
Instruction Scope
SKILL.md stays on-purpose: it instructs the agent to verify account link status then call defined MCP tools (daily briefing, action plan, etc.). It does instruct the user to add the API key to environment and to mcporter config (which results in a token being stored in a local config file) and to restart the OpenClaw gateway; those setup steps touch local configuration and restart an agent service but are expected for wiring an external MCP service.
Install Mechanism
There is no install spec or code to download — the skill is documentation-only. It suggests installing mcporter via npm (npm install -g mcporter), which is a typical external dependency and not part of the skill package itself.
Credentials
Only one credential (BESTYOU_API_KEY) is required, which is proportional. However, the docs recommend exporting the key into shell profiles and/or embedding it into a local mcporter config file (~/.openclaw/workspace/config/mcporter.json), which stores the bearer token in plaintext. That is functional but has security tradeoffs the user should consider (use revocable scoped keys and secure storage).
Persistence & Privilege
always is false and the skill is user-invocable; it does not request persistent platform privileges. The setup steps lead to creating/updating a local mcporter config and restarting the gateway, which is standard for connecting a new MCP endpoint and is within the expected scope.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bestyou
  3. After installation, invoke the skill by name or use /bestyou
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Integrates BestYou health intelligence with your AI agent via MCP. - Synchronizes data from Apple Watch, Oura Ring, CGM, and HealthKit to create an adaptive daily action plan. - Provides tools to query readiness, generate personalized workouts, analyze meals, and manage your daily plan. - Powered by 19 specialized on-device AI agents coordinating fitness, nutrition, sleep, and recovery. - Emphasizes privacy: Only processed insights are shared; raw health data remains on your device. - Includes clear setup instructions and safety guidelines for protecting user data.
Metadata
Slug bestyou
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is BestYou Health Intelligence?

Connect your AI agent to BestYou health intelligence via MCP. 19 on-device AI agents coordinate fitness, nutrition, sleep, and recovery into an adaptive dail... It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.

How do I install BestYou Health Intelligence?

Run "/install bestyou" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is BestYou Health Intelligence free?

Yes, BestYou Health Intelligence is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does BestYou Health Intelligence support?

BestYou Health Intelligence is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created BestYou Health Intelligence?

It is built and maintained by kentsteffen (@kentsteffen); the current version is v1.0.0.

💬 Comments