# VitalTrends - Full LLM Context

> VitalTrends is a unified personal health analytics dashboard for WHOOP, Oura, Apple Health, Withings, and training-log data from Hevy, API uploads, and imports.

Last updated: 2026-08-07

Use this file when a longer context window is available. For a concise curated link list, use https://vitaltrends.net/llms.txt.

## Product Summary

VitalTrends is a SaaS dashboard for people who want long-term personal health trend analysis across multiple data sources. It brings wearable, smart scale, fitness, and training-log data into one timeline so users can compare sleep, recovery, training load, body composition, workouts, and readiness over weeks, months, and years.

The product is built and maintained by Daniel Andrade, a solo developer based in Lisbon, Portugal. The project exists because native wearable apps tend to emphasize daily scores, while VitalTrends emphasizes durable personal history, cross-source comparison, exports, and AI-friendly access.

VitalTrends is not a medical device. It does not provide medical advice, diagnosis, treatment, or emergency guidance.

## Audience

VitalTrends is for:

- WHOOP, Oura, Apple Health, Withings, and training-log users who want one long-term dashboard.
- Athletes tracking recovery, HRV baseline shifts, strain, workouts, strength volume, and body composition.
- Health-conscious individuals who own multiple devices and want their data side by side.
- Users who want CSV export, REST API access, or MCP access for personal analysis and AI-assisted review.
- People who find native wearable apps too focused on the current day and not enough on multi-month trends.

## Core Features

- Unified dashboards for recovery, readiness, HRV, resting heart rate, sleep, strain, workouts, weight, and body composition.
- Automatic sync through OAuth, webhooks, background jobs, API keys, and an iOS companion app.
- Long-term historical storage without artificial chart-history expiration.
- CSV export for personal analysis and upload to AI tools.
- REST API for reading health data and for uploading strength workouts from an agent (write access), deduplicated into the Training Log and grouped with strongly overlapping device sessions when a precise start time is supplied.
- Training Log import for original MacroFactor CSV and XLSX workout exports, including normalized weights, timed sets, and automatic muscle-group classification for standard exercise names.
- MCP server for AI clients such as Claude Desktop.
- Public profile support for users who choose to share selected dashboard data.

## Supported Sources

| Source | Connection method | Data coverage |
|--------|-------------------|---------------|
| WHOOP | OAuth and webhooks | Recovery score, HRV, resting heart rate, sleep stages, sleep performance, strain, workouts, cycles |
| Oura | OAuth and webhooks/catch-up sync | Sleep, readiness, activity, workouts, SpO2, stress, resilience, VO2 max |
| Apple Health | Current VitalTrends iOS companion app through TestFlight | Steps, distance, energy, heart rate, HRV, wrist temperature, systolic and diastolic blood pressure, sleep, workouts, body mass, body fat, many HealthKit categories |
| Withings | OAuth and webhooks | Weight, body composition, Sleep Analyzer summaries, supported vitals, native workouts, and intraday workout heart rate and SpO2 when available |
| Hevy | Personal API key and webhooks | Strength workouts, exercises, sets, reps, weight, distance, duration, RPE, volume, PR context |
| MacroFactor | CSV or XLSX upload | Workout sessions, exercises, warm-up and standard sets, reps, weight, duration, distance, RIR-derived RPE, muscle-group analytics |

Dashboard range controls are explicitly scoped. WHOOP keeps its latest status independent from trend ranges, Oura status cards show the latest reading within the selected period, Apple Health labels its fixed-history cycle exception, and Withings keeps latest snapshot cards independent from its trend range.

## Pricing

Public pricing is available at https://vitaltrends.net/pricing.

Current public pricing shown on the site:

- Monthly: $5/month, with a 7-day free trial when eligible.
- Yearly: $42/year.
- Lifetime: $99 one-time founding price.
- Refund policy: 14-day refund guarantee.

All plans include the main dashboard features, CSV export, REST API access, and MCP access.

## Data And Privacy Boundaries

VitalTrends handles sensitive personal health data. User health data, exports, billing, developer API keys, authenticated API responses, and MCP results require authentication. The public `llms.txt` and this full context file should describe the product and documentation, not expose private user data.

VitalTrends stores data to provide the service to the user. The public privacy policy is at https://vitaltrends.net/privacy. Users can disconnect integrations and delete their account from inside the product.

When a user exports CSV files or sends API data to an AI provider, that data leaves VitalTrends and is subject to the destination provider's policy.

## Documentation Map

- Documentation index: https://vitaltrends.net/docs/index.html.md
- WHOOP markdown docs: https://vitaltrends.net/docs/whoop.md
- Oura markdown docs: https://vitaltrends.net/docs/oura.md
- Withings markdown docs: https://vitaltrends.net/docs/withings.md
- Apple Health markdown docs: https://vitaltrends.net/docs/apple-health.md
- Current Apple Health iOS app: https://testflight.apple.com/join/xc4e2rGR
- Workout log docs: https://vitaltrends.net/docs/api.md and https://vitaltrends.net/docs/hevy.md
- REST API markdown docs: https://vitaltrends.net/docs/api.md
- AI integration markdown docs: https://vitaltrends.net/docs/ai.md
- MCP server markdown docs: https://vitaltrends.net/docs/mcp.md

## API Overview

The REST API base URL is:

```text
https://vitaltrends.net/api/v1
```

API requests require:

```text
Authorization: Bearer YOUR_API_KEY
```

Primary API areas:

- Workouts: unified cross-source workouts, training-log details, MacroFactor CSV/XLSX imports, strength workout uploads from agents, and chart-ready muscle group usage for a date range or all time. Uploaded exercises can include a validated `muscle_group`; unknown names are retained for review, and a user correction is reused for historical analytics and future inputs. Workout-log exercise responses expose the resolved group. Workout creates, agent-row imports, and edits accept ISO or local start/end timing or a duration. Responses expose UTC and local timing plus computed duration. `dedup_mode=preview` is strictly read-only and reports whether the normalized request would create, merge, or update. Agent-added sets join a strongly overlapping WHOOP, Apple Health, or other device workout when the upload includes a precise start time.
- WHOOP: daily recovery, recovery freshness, workouts, and sleep.
- Oura: daily sleep, sleep sessions, readiness, activity, workouts, SpO2, stress, resilience, and VO2 max.
- Withings: measurements, body composition, Sleep Analyzer summaries, native workouts, and intraday activity samples. Native workouts join the unified workout feed and pair with overlapping Apple Health, WHOOP, Oura, Hevy, Strava, or VitalTrends records.
- Apple Health: dashboard trends for systolic and diastolic blood pressure, plus daily summaries, daily aggregates, and per-type samples including wrist temperature.

Use https://vitaltrends.net/docs/api.md as the canonical API reference.
It covers training logs, health data, and chart-friendly aggregations.

## MCP Overview

The MCP server lets compatible AI clients query authenticated VitalTrends data through tools. It uses the user's VitalTrends API key and only returns data for that user.

Typical setup:

```bash
npm install -g @vitaltrends/mcp-server
```

Then configure the client with `VITALTRENDS_API_KEY`.

Use https://vitaltrends.net/docs/mcp.md as the canonical MCP setup guide.

## AI Workflows

VitalTrends supports three AI-friendly workflows:

- CSV export for upload into Claude, ChatGPT, or another AI tool.
- REST API access for notebooks, scripts, or custom AI agents.
- MCP server access for AI clients that can call tools in real time.

Use https://vitaltrends.net/docs/ai.md for guidance and examples.

## Public Site Links

- Homepage: https://vitaltrends.net
- Pricing: https://vitaltrends.net/pricing
- Demo: https://vitaltrends.net/demo
- About: https://vitaltrends.net/about
- Blog: https://vitaltrends.net/blog
- Changelog: https://vitaltrends.net/changelog
- Contact: https://vitaltrends.net/contact
- Privacy: https://vitaltrends.net/privacy
- Terms: https://vitaltrends.net/terms
- Sitemap: https://vitaltrends.net/sitemap.xml
- Blog sitemap: https://vitaltrends.net/blog/sitemap.xml
- RSS: https://vitaltrends.net/blog/feed.xml
- Atom: https://vitaltrends.net/blog/feed.atom