WHOOP über MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → WHOOP klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

WHOOP + Microsoft Copilot

Recovery, HRV, Ruhepuls, Schlaf und Nickerchen mit Schlafphasen, Day Strain pro Zyklus, Workouts mit Herzfrequenzzonen, Profil und Körpermaße eines WHOOP-Mitglieds über die WHOOP Developer API v2 mit OAuth lesen. Nur lesend.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert einmalig etwa 10 Minuten. Du brauchst ein WHOOP-Konto.

1. Öffne das WHOOP Developer Dashboard unter https://developer-dashboard.whoop.com und melde dich mit einem WHOOP-Konto an. Leg ein Team an, wenn du dazu aufgefordert wirst (ein Team kann bis zu 5 Apps enthalten).
2. Klicke auf Create App. Hake unter Scopes read:profile, read:body_measurement, read:cycles, read:recovery, read:sleep und read:workout an. Der Connector fragt außerdem nach offline, das WHOOP braucht, um ein Refresh-Token auszustellen.
3. Füge unter Redirect URIs https://cloud.anythingmcp.com/api/mcp-oauth/callback für AnythingMCP Cloud hinzu oder <your AnythingMCP URL>/api/mcp-oauth/callback, wenn du AnythingMCP selbst hostest.
4. Speichere und kopiere Client ID und Client Secret in WHOOP_CLIENT_ID und WHOOP_CLIENT_SECRET. Installiere den Connector, klicke auf Authorize with Provider und erlaube den Zugriff mit dem WHOOP-Konto, dessen Daten die KI lesen soll.
5. Rufe whoop_get_profile auf, um die Verbindung zu prüfen.

Access-Tokens gelten etwa eine Stunde und werden automatisch erneuert; WHOOP ersetzt das Refresh-Token bei jeder Erneuerung.

Was er liest: Profil und Körpermaße des verbundenen Mitglieds (Größe, Gewicht, maximale Herzfrequenz); physiologische Zyklen, wobei ein Zyklus ein WHOOP-Tag vom Aufwachen bis zum nächsten Aufwachen ist, mit Day Strain, Energie und Herzfrequenz; die Recovery jedes Zyklus mit Recovery Score, HRV, Ruhepuls und, ab WHOOP 4.0, SpO2 und Hauttemperatur; Schlaf und Nickerchen mit der Zeit pro Schlafphase, Schlafbedarf, Performance, Regelmäßigkeit, Effizienz und Atemfrequenz; und Workouts mit Sportart, Strain, Herzfrequenz, Energie, Distanz, Höhe und Zeit in jeder Herzfrequenzzone.

Einen Tag finden: Die KI listet Zyklen (der neueste hat kein end, solange er läuft) und geht von einer Zyklus-ID zu dessen Recovery und Schlaf. Für Trends listet sie Recoveries, Schlafeinheiten oder Workouts zwischen einem start und einem end.

Nur lesend: Jedes Tool liest nur. Die WHOOP API bietet keine Möglichkeit, Daten zu schreiben, es gibt also nichts zu bestätigen, und kein Tool ist bei der Installation deaktiviert. Journal-Einträge, der Stress Monitor, Herzfrequenz-Streams und WHOOP Coach sind nicht Teil der öffentlichen API.

Formate: Nur Datensätze mit score_state SCORED haben einen Score; PENDING_SCORE heißt, WHOOP berechnet ihn noch, UNSCORABLE, dass er nie berechnet wird (zum Beispiel, wenn das Armband nicht getragen wurde). Zeiten sind UTC, und timezone_offset ist der lokale Zeitversatz des Mitglieds, den die KI anwendet, bevor sie einen lokalen Tag nennt. Dauern, die auf _milli enden, sind Millisekunden. Strain nutzt WHOOPs Skala von 0 bis 21, kilojoule ist Energie (für Kilokalorien durch 4,184 teilen), Prozentwerte reichen von 0 bis 100, und Herzfrequenzen sind Schläge pro Minute.

Limits: Listen-Tools liefern bis zu 25 Datensätze pro Aufruf, neueste zuerst, mit einem next_token, solange es weitere gibt. WHOOP erlaubt standardmäßig 100 Anfragen pro Minute und 10.000 pro Tag und App; darüber antwortet es mit 429.

Häufige Fehler: 401 bedeutet, dass die Autorisierung abgelaufen ist oder widerrufen wurde (klicke erneut auf Authorize with Provider), 403 oder eine leere Antwort für eine Datenart heißt meist, dass ihr Scope nicht gewährt wurde, und 404 eine unbekannte ID.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die WHOOP-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie hoch ist heute mein Recovery Score, und wie liegen meine HRV und mein Ruhepuls im Vergleich zu meinem 30-Tage-Durchschnitt?“
• „Wie lange habe ich diese Woche jede Nacht geschlafen, und wie viel davon war REM- und Tiefschlaf?“
• „Liste meine Workouts der letzten zwei Wochen mit Sportart, Strain und Zeit in den Herzfrequenzzonen 4 und 5.“
• „Wie sah meine Recovery an den Morgen nach einem Day Strain über 15 aus?“
• „Habe ich diesen Monat Nickerchen gemacht, und wie lange waren sie?“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden