Read Garmin data
getFetches data from one read-only Garmin Personal API endpoint and returns compact JSON. Use path, parameters, and optional fields to request activities, sleep, heart rate, or Garmin Connect data.
Instructions
Call one Garmin Personal API endpoint (GET only) and return compact JSON.
path: an endpoint path exactly as listed by list_endpoints (with the {placeholders}).
params: values for that endpoint's path and query parameters, e.g.
{"startDate": "2026-11-01", "endDate": "2026-11-09"}. For the activity search endpoint,
limit is the total number of activities wanted (pages are fetched automatically, up to
1000) and startDate/endDate filter by date.
fields: optional dotted paths to keep, e.g. ["startTimeLocal", "distance",
"averageRunningCadenceInStepsPerMinute"]. Activities come with a useful default set
when fields is omitted.
Returns {"data": ..., "partial": bool, "notes": [...], "key_warning": str|null}.
If partial is true, read notes: the result was cut and says how to narrow the request.
Responses are capped at about 40,000 characters (roughly 150 activities in the default view):
for long periods pass a short fields list. If key_warning is not null, tell the user.
If update_available is present, tell the user once (version and how to update).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "get"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| fields | No | ||
| params | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |