@etweisberg/garmin-connect-mcp 0.1.14 → 0.1.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -56
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -59,51 +59,56 @@ Session cookies expire after a few hours. Re-run the login flow when they do.
|
|
|
59
59
|
## Available Tools
|
|
60
60
|
|
|
61
61
|
### Session & Auth
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
|
65
|
-
| `
|
|
66
|
-
| `
|
|
62
|
+
|
|
63
|
+
| Tool | Description |
|
|
64
|
+
| --------------- | --------------------------------------------------------- |
|
|
65
|
+
| `garmin-login` | Returns login instructions for the Playwright MCP browser |
|
|
66
|
+
| `check-session` | Validates the saved session is still active |
|
|
67
|
+
| `run-tests` | Returns a test plan to verify all tools work |
|
|
67
68
|
|
|
68
69
|
### Activities
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
|
72
|
-
| `
|
|
73
|
-
| `get-activity
|
|
74
|
-
| `get-activity-
|
|
75
|
-
| `get-activity-
|
|
76
|
-
| `get-activity-
|
|
77
|
-
| `get-activity-
|
|
78
|
-
| `
|
|
70
|
+
|
|
71
|
+
| Tool | Description |
|
|
72
|
+
| ----------------------- | -------------------------------------------------------- |
|
|
73
|
+
| `list-activities` | List activities with pagination |
|
|
74
|
+
| `get-activity` | Full activity summary (distance, duration, HR, calories) |
|
|
75
|
+
| `get-activity-details` | Time-series metrics (HR, cadence, elevation over time) |
|
|
76
|
+
| `get-activity-splits` | Lap/split data |
|
|
77
|
+
| `get-activity-hr-zones` | Heart rate time-in-zone breakdown |
|
|
78
|
+
| `get-activity-polyline` | Full-resolution GPS track |
|
|
79
|
+
| `get-activity-weather` | Weather conditions during activity |
|
|
80
|
+
| `download-fit` | Download original FIT file |
|
|
79
81
|
|
|
80
82
|
### Daily Health
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
|
84
|
-
| `get-daily-
|
|
85
|
-
| `get-daily-
|
|
86
|
-
| `get-daily-
|
|
87
|
-
| `get-daily-
|
|
88
|
-
| `get-daily-
|
|
89
|
-
| `get-daily-
|
|
83
|
+
|
|
84
|
+
| Tool | Description |
|
|
85
|
+
| ----------------------------- | -------------------------------------------- |
|
|
86
|
+
| `get-daily-summary` | Steps, calories, distance, intensity minutes |
|
|
87
|
+
| `get-daily-heart-rate` | Heart rate data throughout the day |
|
|
88
|
+
| `get-daily-stress` | Stress levels throughout the day |
|
|
89
|
+
| `get-daily-summary-chart` | Combined wellness chart data |
|
|
90
|
+
| `get-daily-intensity-minutes` | Intensity minutes for a date |
|
|
91
|
+
| `get-daily-movement` | Movement/activity data |
|
|
92
|
+
| `get-daily-respiration` | Respiration rate data |
|
|
90
93
|
|
|
91
94
|
### Sleep / Body Battery / HRV
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
|
95
|
+
|
|
96
|
+
| Tool | Description |
|
|
97
|
+
| ------------------ | ----------------------------------- |
|
|
98
|
+
| `get-sleep` | Sleep score, duration, stages, SpO2 |
|
|
95
99
|
| `get-body-battery` | Body battery charged/drained values |
|
|
96
|
-
| `get-hrv`
|
|
100
|
+
| `get-hrv` | Heart rate variability data |
|
|
97
101
|
|
|
98
102
|
### Weight / Records / Fitness
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
|
102
|
-
| `get-
|
|
103
|
-
| `get-
|
|
104
|
-
| `get-
|
|
105
|
-
| `get-
|
|
106
|
-
| `get-
|
|
103
|
+
|
|
104
|
+
| Tool | Description |
|
|
105
|
+
| ---------------------- | ------------------------------------- |
|
|
106
|
+
| `get-weight` | Weight measurements over a date range |
|
|
107
|
+
| `get-personal-records` | All personal records with history |
|
|
108
|
+
| `get-fitness-stats` | Aggregated activity stats by type |
|
|
109
|
+
| `get-vo2max` | Latest VO2 Max estimate |
|
|
110
|
+
| `get-hr-zones-config` | Heart rate zone boundaries |
|
|
111
|
+
| `get-user-profile` | User profile and settings |
|
|
107
112
|
|
|
108
113
|
## Architecture
|
|
109
114
|
|
|
@@ -141,13 +146,13 @@ npm run build
|
|
|
141
146
|
|
|
142
147
|
### Scripts
|
|
143
148
|
|
|
144
|
-
| Command
|
|
145
|
-
|
|
146
|
-
| `npm run build`
|
|
147
|
-
| `npm run lint`
|
|
148
|
-
| `npm run format`
|
|
149
|
-
| `npm run typecheck` | Type check without emitting
|
|
150
|
-
| `npm test`
|
|
149
|
+
| Command | Description |
|
|
150
|
+
| ------------------- | ---------------------------------------------- |
|
|
151
|
+
| `npm run build` | Compile TypeScript |
|
|
152
|
+
| `npm run lint` | Run ESLint |
|
|
153
|
+
| `npm run format` | Format with Prettier |
|
|
154
|
+
| `npm run typecheck` | Type check without emitting |
|
|
155
|
+
| `npm test` | Run integration tests (requires valid session) |
|
|
151
156
|
|
|
152
157
|
### Local Integration Testing
|
|
153
158
|
|
|
@@ -159,7 +164,7 @@ npm test
|
|
|
159
164
|
|
|
160
165
|
## Contributing
|
|
161
166
|
|
|
162
|
-
1.
|
|
167
|
+
1. Create a feature branch off `main`
|
|
163
168
|
2. Make your changes
|
|
164
169
|
3. Run checks:
|
|
165
170
|
```bash
|
|
@@ -175,20 +180,14 @@ CI runs lint, format check, typecheck, and build on every PR. Integration tests
|
|
|
175
180
|
|
|
176
181
|
### Releasing
|
|
177
182
|
|
|
178
|
-
Releases are automated
|
|
179
|
-
|
|
180
|
-
```bash
|
|
181
|
-
# Bump version
|
|
182
|
-
npm version patch # or minor, major
|
|
183
|
+
Releases are fully automated. Every merge to `main` triggers the release workflow which:
|
|
183
184
|
|
|
184
|
-
|
|
185
|
-
|
|
185
|
+
1. Runs CI (lint, format, typecheck, build)
|
|
186
|
+
2. Bumps the patch version
|
|
187
|
+
3. Publishes to npm with provenance
|
|
188
|
+
4. Creates a GitHub Release
|
|
186
189
|
|
|
187
|
-
|
|
188
|
-
# 1. Build the package
|
|
189
|
-
# 2. Publish to npm with provenance
|
|
190
|
-
# 3. Create a GitHub Release
|
|
191
|
-
```
|
|
190
|
+
No manual version bumping or tagging needed — just merge your PR.
|
|
192
191
|
|
|
193
192
|
## License
|
|
194
193
|
|