Skip to content
Back to search

mywhoosh-mcp

Unofficial MCP server for MyWhoosh: create, list, delete and schedule custom cycling workouts

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/derbauer97--mywhoosh-mcp/badge.svg)](/listings/derbauer97--mywhoosh-mcp)

HTML

<a href="/listings/derbauer97--mywhoosh-mcp"><img src="/api/listings/derbauer97--mywhoosh-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Python 3.12+ and [uv](https://docs.astral.sh/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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 90 lines
  1. # mywhoosh-mcp
  2. Small, unofficial [MCP](https://modelcontextprotocol.io) server for [MyWhoosh](https://mywhoosh.com):
  3. create, list, delete and schedule **custom cycling workouts**. Written from scratch against the
  4. MyWhoosh API as used by the official app and the web editor at workout.mywhoosh.com.
  5. Not affiliated with MyWhoosh. The API is undocumented and may change at any time.
  6. ## Tools
  7. | Tool | What it does |
  8. | --- | --- |
  9. | `mywhoosh_create_workout` | Build a workout from simple blocks (% FTP) and upload it. ERG on/off per workout. |
  10. | `mywhoosh_update_workout` | Replace a custom workout in place (same id, calendar entries stay). |
  11. | `mywhoosh_list_workouts` | List custom workouts (optionally with a per-step breakdown) and free slots. |
  12. | `mywhoosh_delete_workout` | Delete a custom workout (refuses if a training plan uses it, unless `force`). |
  13. | `mywhoosh_schedule_workout` | Put a custom workout on the MyWhoosh calendar (date + local start time). |
  14. | `mywhoosh_list_scheduled_workouts` | List calendar entries in a date range. |
  15. | `mywhoosh_unschedule_workout` | Remove a calendar entry (the workout stays). |
  16. | `mywhoosh_get_profile` | FTP, weight, height and best power values from the MyWhoosh profile. |
  17. | `mywhoosh_set_ftp` | Set the cycling FTP (only that field changes; verified after writing). |
  18. Block types for `mywhoosh_create_workout`:
  19. ```json
  20. [
  21. {"type": "warmup", "duration_s": 600, "start_power": 50, "end_power": 75},
  22. {"type": "interval", "duration_s": 240, "power": 105, "repeat": 4, "rest_duration_s": 180, "rest_power": 55},
  23. {"type": "steady", "duration_s": 1200, "power": 70, "cadence": 90,
  24. "messages": [{"at_s": 10, "text": "Relax your shoulders"}]},
  25. {"type": "freeride", "duration_s": 300},
  26. {"type": "cooldown", "duration_s": 300, "start_power": 65, "end_power": 45}
  27. ]
  28. ```
  29. ## Install
  30. Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/).
  31. ```sh
  32. uv tool install git+https://github.com/derbauer97/mywhoosh-mcp
  33. ```
  34. Credentials are read from environment variables, or on macOS from the Keychain:
  35. ```sh
  36. # Option A: environment
  37. export MYWHOOSH_USERNAME=you@example.com MYWHOOSH_PASSWORD=...
  38. # Option B: macOS Keychain (service name "mywhoosh-mcp"); -w without a value prompts for the password
  39. security add-generic-password -U -s mywhoosh-mcp -a you@example.com -w
  40. ```
  41. MCP client config:
  42. ```json
  43. {
  44. "mcpServers": {
  45. "mywhoosh": { "command": "mywhoosh-mcp" }
  46. }
  47. }
  48. ```
  49. Optional: `MYWHOOSH_TZ` (default `Europe/Berlin`) sets the time zone for scheduling.
  50. ## Things the API does that you should know
  51. - **One session per account.** While the MyWhoosh app is logged in, API logins are rejected
  52. ("already logged in from another device"). Close the app; the lock clears after a few minutes.
  53. The access token is cached in `~/.cache/mywhoosh-mcp/token.json` (mode 0600) to avoid re-logins.
  54. - **ASCII only.** The backend silently drops non-ASCII characters, so names, descriptions and
  55. messages are transliterated (`ö` -> `oe`, `ß` -> `ss`, `–` -> `-`).
  56. - **Writes are asynchronous** and overlapping writes can be lost. The server serializes uploads and
  57. deletes and only returns once the change is visible (`confirmed: true`).
  58. - **Limited slots** on free accounts (custom workout "credits"); `mywhoosh_list_workouts` reports
  59. `free_slots`. Updating a workout in place does not use a slot.
  60. - **Calendar entries keep their own copy** of name and TSS; `mywhoosh_update_workout` does not
  61. change them.
  62. - Cycling only. Whether `ERGMode: E_ON` makes the app start in ERG mode is up to the app.
  63. ## Development
  64. ```sh
  65. uv sync
  66. uv run pytest
  67. ```
  68. ## License
  69. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.