garmin-connect-plugin-for-dsh

dsh-plugin-garmin-connect A TypeScript-based Garmin Connect plugin and MCP server with official Personal API and secure browser-based MFA, built for DeepSeek Harness and designed to work with other AI agents.

English | 简体中文 | Test Report | Changelog

Developed by Li Erniu (李二牛), connecting Garmin training to your AI assistant.

This open-source DeepSeek Harness plugin and MCP connector support Garmin China and International accounts. Explore full activities and splits, sleep, heart rate and HRV with AI, then create, schedule or delete workouts or cancel calendar entries after your confirmation.

You control your account. Your password is not shared with AI. With the recommended Garmin browser sign-in, passwords and verification codes are entered only on Garmin’s official page, not given to AI or the developer. Session credentials are stored locally with restricted file permissions. Authorized fitness and health queries return data to your chosen AI client for analysis.

Works with mainstream coding agents and AI workspaces DeepSeek Harness · WorkBuddy · Qwen Work · ZCode · Claude Code · Codex · Cursor · Windsurf Connect through MCP or a SKILL.md workflow, depending on the client. [!NOTE] MFA support in 0.1.6: local dsh Web, the garmin-connect-auth serve system-browser flow, and MCP URL elicitation can bootstrap the same owner-only session for China and International accounts. Real-account MFA completed in both regions on 2026-08-29, including a full China-region browser-to-session-and-read chain and an International-region system-browser DI exchange with owner-only session persistence. Browser policy may still block an individual flow. The older login --browser command is retained only as a diagnostic. More Apps What It Does

This plugin connects DeepSeek Harness or any MCP-compatible AI agent to Garmin Connect, exposing your wearable data as AI-callable tools. Once installed, the agent can automatically query your activities, sleep, steps, and heart rate to provide personalized fitness insights — all through natural language. Registered Tools

Version 0.1.21 registers 30 tools in Harness (including list_garmin_accounts) and 31 tools in shared-workspace MCP (also including open_garmin_workspace). The selected account's provider determines which operations are available. Legacy single-account Connect MCP retains 29 tools. Of those base tools, twenty-four provide queries or local advice without writing; download_garmin_activity_fit writes one local file on the MCP/dsh host. Creating, scheduling or deleting a workout and cancelling a calendar entry change Garmin data after explicit confirmation. Legacy Personal MCP servers expose 15 compatible tools for Garmin reads, local FIT downloads and local coaching knowledge. Harness and shared-workspace MCP keep stable tool catalogs and route each call by the selected account’s capabilities. The 13 recovery and training tools introduced in 0.1.14 depend on the published maintained SDK through an exact npm alias; see Maintained SDK dependency. Recovery and training tools (introduced in 0.1.14)

These tools are shared by DSH and MCP and map directly to the maintained SDK: Blood oxygen and respiration (introduced in 0.1.18)

These read-only tools are shared by DSH and MCP and use the maintained SDK's authenticated HTTP transport. They preserve the complete service response, including available summary fields, descriptors and time series: Ask, for example: “Show my blood oxygen and respiration records for October 20, 2026.” Both tools take a single date; no range parameter is accepted. Availability depends on the selected account, date and recorded device data. Missing fields, null and empty arrays stay missing; they are not converted to zero. Update the plugin/MCP server and reconnect before using these tools, then check the actual