The Garmin Workouts MCP Server authenticates with Garmin Connect using garth [https://github.com/matin/garth]. There are two primary ways to provide your Garmin credentials:
1. Using Environment Variables
You can set your Garmin Connect email and password as environment variables before starting the MCP server.
Alternatively, you can log in to Garmin Connect once using the garth library directly and save your authentication tokens to a directory, which the MCP server will then use for subsequent sessions. This method is useful if you prefer not to store your credentials as environment variables or as part of your MCP client configuration.
To log in out-of-band:
Install garth:
pip install garth
Run the following Python script in your terminal:
import garth
from getpass import getpass
email = input("Enter email address: ")
password = getpass("Enter password: ")
# If there's MFA, you'll be prompted during the login
garth.login(email, password)
garth.save("~/.garth")
Follow the prompts to enter your Garmin Connect email and password. Upon successful login, garth will save your authentication tokens to ~/.garth.
The MCP server will automatically look for these saved tokens. If you wish to store them in a custom location, you can set the GARTH_HOME environment variable.
Usage
This server provides the following MCP tools that can be used through any MCP-compatible client:
Generate Workout Data Prompt
Use the generate_workout_data_prompt tool to create a prompt for an LLM to generate structured workout data:
generate_workout_data_prompt("10 min warmup, 5x(1km at 4:30 pace, 2min recovery), 10 min cooldown")
Upload Workout
Use the upload_workout tool to upload structured workout data to Garmin Connect:
upload_workout(workout_data_json)
Schedule Workout
Use the schedule_workout tool to schedule a workout on a specific date:
schedule_workout("workout_id_here", "2024-01-15")
Delete Workout
Use the delete_workout tool to remove a workout from Garmin Connect:
delete_workout("workout_id_here")
List Workouts
list_workouts()
Get Workout Details
get_workout("workout_id_here")
List Activities
Use the list_activities tool to view completed activities (runs, rides, swims, etc.) from Garmin Connect:
list_activities()
Optional parameters:
limit: Number of activities to return (default: 20)
start: Starting position for pagination (default: 0)
activityType: Filter by activity type (e.g., "running", "cycling", "swimming")
search: Search for activities containing specific text
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Câu hỏi
Làm thế nào để cài đặt Garmin Workouts?
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Garmin Workouts có cần khóa API không?
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Garmin Workouts dùng giao thức truyền tải nào?
Garmin Workouts chạy cục bộ qua stdio.
Garmin Workouts được kiểm tra lần cuối khi nào?
Kiểm tra lần cuối: 2026-10-28. MCP server with tools to manage workouts on Garmin Connect