Skip to main content
Glama

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

mywhoosh_create_workout

Build a workout from simple blocks (% FTP) and upload it. ERG on/off per workout.

mywhoosh_update_workout

Replace a custom workout in place (same id, calendar entries stay).

mywhoosh_list_workouts

List custom workouts (optionally with a per-step breakdown) and free slots.

mywhoosh_delete_workout

Delete a custom workout (refuses if a training plan uses it, unless force).

mywhoosh_schedule_workout

Put a custom workout on the MyWhoosh calendar (date + local start time).

mywhoosh_list_scheduled_workouts

List calendar entries in a date range.

mywhoosh_unschedule_workout

Remove a calendar entry (the workout stays).

mywhoosh_get_profile

FTP, weight, height and best power values from the MyWhoosh profile.

mywhoosh_set_ftp

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-mcp

Credentials 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 -w

MCP 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_workouts reports free_slots. Updating a workout in place does not use a slot.

  • Calendar entries keep their own copy of name and TSS; mywhoosh_update_workout does not change them.

  • Cycling only. Whether ERGMode: E_ON makes the app start in ERG mode is up to the app.

Development

uv sync
uv run pytest

License

MIT

Available Tools

9 tools
mywhoosh_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

    A4/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      8
      49 npm
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables creating and managing COROS strength, running, and cycling workouts via the Training Hub API, including calendar management, weekly planning, validation, backups, and training analytics.
      56
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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