get_device_settings
Retrieve settings and configuration for any Garmin device using its device ID. Access device-specific options and preferences from Garmin Connect.
Instructions
Get settings and configuration for a specific Garmin device
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deviceId | Yes | The Garmin device ID |
Implementation Reference
- src/client/garmin.client.ts:464-466 (handler)Client handler that performs the HTTP request to fetch device settings from the Garmin API using the DEVICE_SETTINGS_ENDPOINT with the given deviceId.
async getDeviceSettings(deviceId: string): Promise<unknown> { return this.request(`${DEVICE_SETTINGS_ENDPOINT}/${deviceId}`); } - src/dtos/devices.dto.ts:4-10 (schema)Type definition (GetDeviceSettingsDto) and Zod validation schema (getDeviceSettingsSchema) for the 'get_device_settings' tool input, requiring a deviceId string.
export type GetDeviceSettingsDto = { deviceId: string; }; export const getDeviceSettingsSchema = z.object({ deviceId: z.string().describe('The Garmin device ID'), }); - src/tools/profile.tools.ts:52-64 (registration)Registration of the 'get_device_settings' tool on the MCP server, with description, input schema, and handler that calls client.getDeviceSettings(deviceId).
server.registerTool( 'get_device_settings', { description: 'Get settings and configuration for a specific Garmin device', inputSchema: getDeviceSettingsSchema.shape, }, async ({ deviceId }) => { const data = await client.getDeviceSettings(deviceId); return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }], }; }, ); - The API endpoint constant DEVICE_SETTINGS_ENDPOINT used by the client to construct the request URL for device settings.
export const DEVICE_SETTINGS_ENDPOINT = '/device-service/deviceservice/device-info/settings';