mywhoosh-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mywhoosh-mcp Create a 60-minute interval workout and schedule it for Saturday at 9am."
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.
mywhoosh-mcp
Small, unofficial MCP server for MyWhoosh: create, list, delete and schedule custom cycling workouts. Written from scratch against the MyWhoosh API as used by the official app and the web editor at workout.mywhoosh.com.
Not affiliated with MyWhoosh. The API is undocumented and may change at any time.
Tools
Tool | What it does |
| Build a workout from simple blocks (% FTP) and upload it. ERG on/off per workout. |
| Replace a custom workout in place (same id, calendar entries stay). |
| List custom workouts (optionally with a per-step breakdown) and free slots. |
| Delete a custom workout (refuses if a training plan uses it, unless |
| Put a custom workout on the MyWhoosh calendar (date + local start time). |
| List calendar entries in a date range. |
| Remove a calendar entry (the workout stays). |
| FTP, weight, height and best power values from the MyWhoosh profile. |
| Set the cycling FTP (only that field changes; verified after writing). |
Block types for mywhoosh_create_workout:
[
{"type": "warmup", "duration_s": 600, "start_power": 50, "end_power": 75},
{"type": "interval", "duration_s": 240, "power": 105, "repeat": 4, "rest_duration_s": 180, "rest_power": 55},
{"type": "steady", "duration_s": 1200, "power": 70, "cadence": 90,
"messages": [{"at_s": 10, "text": "Relax your shoulders"}]},
{"type": "freeride", "duration_s": 300},
{"type": "cooldown", "duration_s": 300, "start_power": 65, "end_power": 45}
]Related MCP server: Garmin Connect Workouts MCP
Install
Requires Python 3.12+ and uv.
uv tool install git+https://github.com/derbauer97/mywhoosh-mcpCredentials are read from environment variables, or on macOS from the Keychain:
# Option A: environment
export MYWHOOSH_USERNAME=you@example.com MYWHOOSH_PASSWORD=...
# Option B: macOS Keychain (service name "mywhoosh-mcp"); -w without a value prompts for the password
security add-generic-password -U -s mywhoosh-mcp -a you@example.com -wMCP client config:
{
"mcpServers": {
"mywhoosh": { "command": "mywhoosh-mcp" }
}
}Optional: MYWHOOSH_TZ (default Europe/Berlin) sets the time zone for scheduling.
Things the API does that you should know
One session per account. While the MyWhoosh app is logged in, API logins are rejected ("already logged in from another device"). Close the app; the lock clears after a few minutes. The access token is cached in
~/.cache/mywhoosh-mcp/token.json(mode 0600) to avoid re-logins.ASCII only. The backend silently drops non-ASCII characters, so names, descriptions and messages are transliterated (
ö->oe,ß->ss,–->-).Writes are asynchronous and overlapping writes can be lost. The server serializes uploads and deletes and only returns once the change is visible (
confirmed: true).Limited slots on free accounts (custom workout "credits");
mywhoosh_list_workoutsreportsfree_slots. Updating a workout in place does not use a slot.Calendar entries keep their own copy of name and TSS;
mywhoosh_update_workoutdoes not change them.Cycling only. Whether
ERGMode: E_ONmakes the app start in ERG mode is up to the app.
Development
uv sync
uv run pytestLicense
MIT
Available Tools
9 toolsmywhoosh_create_workoutA
Create a custom cycling workout in MyWhoosh.
blocks are executed in order. Power in % FTP (e.g. 90 = 90% FTP). erg_mode=True: trainer holds the target power (ERG). False: rider controls resistance. ftp_watts is optional and only used to compute kJ. Text (name, description, messages) is transliterated to ASCII (ö->oe, ß->ss, – -> -), because MyWhoosh drops all non-ASCII characters.
Example blocks: {"type":"warmup","duration_s":600,"start_power":50,"end_power":75} {"type":"interval","duration_s":240,"power":105,"repeat":4,"rest_duration_s":180,"rest_power":55} {"type":"steady","duration_s":1200,"power":70,"cadence":90} {"type":"cooldown","duration_s":300,"start_power":65,"end_power":45}
Inputs: name (required), blocks (required), erg_mode, ftp_watts, +1 more.
mywhoosh_delete_workoutA
Delete a custom cycling workout by id (see mywhoosh_list_workouts).
If the workout is used by a training plan, nothing is deleted unless force=True.
Inputs: workout_id (required), force.
mywhoosh_get_profileA
FTP, weight, height and best power values stored in the MyWhoosh profile.
Workout targets in MyWhoosh are % of this FTP, so check it before planning watt targets.
Inputs: no named parameters.
mywhoosh_list_scheduled_workoutsA
List MyWhoosh calendar entries between two dates (YYYY-MM-DD, inclusive, local time).
Inputs: end_date (required), start_date (required).
mywhoosh_list_workoutsA
List custom cycling workouts stored in MyWhoosh (newest first).
include_steps adds a compact per-step breakdown. name_contains filters case-insensitively.
Inputs: include_steps, name_contains.
mywhoosh_schedule_workoutA
Put a custom workout (id from mywhoosh_list_workouts/mywhoosh_create_workout) on the MyWhoosh calendar.
date: YYYY-MM-DD, start_time: HH:MM, both local time (Europe/Berlin).
Inputs: date (required), workout_id (required), start_time.
mywhoosh_set_ftpA
Set the cycling FTP in the MyWhoosh profile (watts, 50-600).
Rewrites the profile with only FtpPlayer changed and verifies that nothing else changed.
Inputs: ftp_watts (required).
mywhoosh_unschedule_workoutA
Remove a calendar entry by task_id (from mywhoosh_list_scheduled_workouts). The workout itself stays.
Inputs: task_id (required).
mywhoosh_update_workoutA
Replace an existing custom workout in place (same id), e.g. to fix a typo or change targets.
Same arguments as mywhoosh_create_workout plus workout_id; the whole workout is replaced. The id stays, so calendar entries keep pointing at it. Calendar entries keep their own copy of name and TSS, which is not updated: re-schedule if those must change.
Inputs: name (required), blocks (required), workout_id (required), erg_mode, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool maps to a distinct resource+action: workout CRUD, calendar scheduling, and profile FTP access are cleanly separated. create_workout and update_workout are distinguished by the explicit 'replace in place' wording and the workout_id parameter.
All nine tools follow the same mywhoosh_verb_noun snake_case pattern (mywhoosh_create_workout, mywhoosh_list_scheduled_workouts, mywhoosh_set_ftp). No mixed conventions or vague verbs.
Nine tools is well within the ideal 3-15 range and every tool covers a real operation. Nothing feels like padding or an accidental duplicate.
Workout lifecycle (create/update/delete/list) and calendar (schedule/list/unschedule) are fully covered, with profile read/write for FTP. Minor gaps: no get_workout-by-id (only list with filters), and profile writes are limited to FTP (no weight/height update).
Maintenance
Related MCP Connectors
List, fetch, create, edit (replace), delete and schedule structured workouts on Garmin Connect (runn
Read your workouts, history, and stats; create and schedule new workouts. Writes are additive only.
Create, edit and organize structured workouts for your bike trainer, treadmill or elliptical.
Create structured workouts and push them to Apple Watch or Garmin.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables listing, creating, editing, deleting, and scheduling structured workouts (run, cycle, swim, triathlon) on Garmin Connect via natural language.MIT
- AlicenseAqualityBmaintenanceEnables users to describe workouts in plain English and have them created as structured Garmin Connect workouts with pace, HR, power, cadence targets, and repeat blocks. Also provides full workout lifecycle management including listing, updating, deleting, and scheduling to the calendar.849 npmMIT
- AlicenseBqualityCmaintenanceEnables creating and managing COROS strength, running, and cycling workouts via the Training Hub API, including calendar management, weekly planning, validation, backups, and training analytics.56MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent training activities and wellness signals such as sleep, HRV, and resting heart rate, then design structured workouts that are written to an intervals.icu calendar and synced onward to Garmin Connect and the user's watch. Also supports listing, editing, and deleting planned workouts.MIT