# Garmin Connect (treinos) — MCP server on mcp.ai
> Listar, obter, criar, editar (substituir), apagar e agendar treinos estruturados no Garmin Connect (corrida, ciclismo, natação, multi-sport / triatlo). Usa a API não oficial via sessão Garmin (email + senha); tokens OAuth são guardados encriptados para reduzir logins.

By: mcp.ai · official
Page: https://mcp.ai/garmin

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_garmin?ms=1781045700000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/garmin/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/garmin/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/garmin/skill.md
Postman collection (v2.1): https://mcp.ai/garmin/postman.json

## Tools
- garmin_delete_workout(workout_id: string, account?: string, workout_ids?: string[]) — Delete a workout template from Garmin Connect by workout_id.
- garmin_edit_workout(workout_id: string, workout: object, account?: string, workout_ids?: string[]) — Replace a workout: uploads a new workout from payload, then deletes workout_id (no native PUT). Returns new workout_id and previous_workout_id.
- garmin_get_scheduled_workout(scheduled_workout_id: string, account?: string, scheduled_workout_ids?: string[]) — Get one scheduled workout entry by scheduled_workout_id.
- garmin_get_workout(workout_id: string, account?: string, workout_ids?: string[]) — Get one workout template by workout_id (full structure: segments, steps, targets). Includes raw_data JSON string.
- garmin_list_accounts(account?: string) — List all Garmin logins linked to this install (id, email, label, created_at).
- garmin_list_scheduled_workouts(year: integer, month: integer, account?: string) — List calendar scheduled workouts for a given month/year from Garmin calendar-service.
- garmin_list_workouts(start?: integer, limit?: integer, account?: string) — List saved workouts from Garmin Connect (workout-service). Returns summaries plus raw_data (full JSON string from Garmin).
- garmin_schedule_workout(workout_id: string, date: string, account?: string, workout_ids?: string[]) — Schedule an existing workout onto the calendar. date must be YYYY-MM-DD (or ISO-8601 date prefix). Returns Garmin schedule response as raw_data.
- garmin_submit_workout(workout: object, account?: string) — Create a new structured workout on Garmin Connect. Body must match Garmin API (workoutName, sportType, workoutSegments with ExecutableStepDTO / RepeatGroupDTO). You may omit displayOrder/displayable e
- garmin_unschedule_workout(scheduled_workout_id: string, account?: string, scheduled_workout_ids?: string[]) — Remove workout from calendar by scheduled_workout_id (does not delete the workout template).

## Example prompts
- "Crie um treino de corrida intervalado e agende pra amanhã"
- "Liste meus treinos da próxima semana"
- "Edite o treino de bike de quinta pra um Z2 longo"

## Links
Docs: https://mcp.ai/docs/mcps/garmin
Website: https://mcp.ai/mcps/garmin