Your own Garmin running and health data: readiness, runs, sleep, trends and patterns. Self-hosted.
MCPpedia last refreshed this data
io.github.Dtsiakas/running-companion is an MCP server that your own Garmin running and health data: readiness, runs, sleep, trends and patterns. Self-hosted. Its tool list has not been published yet over stdio and http, requires no API key, and scores 73/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"io-github-dtsiakas-running-companion": {
"url": "<see-readme-for-url>"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
My personal running and health dashboard, built on Garmin's read-only Personal API. It runs on my Windows laptop: the Garmin key and the database stay there. Claude can read the data through the app's MCP connector. Races, predictions and training plans stay in Garmin Connect.
This server supports HTTP transport. Be the first to test it - help the community know if it works.
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in health
MCP server for the ClinicalTrials.gov v2 API. Search trials, retrieve study details and results, and match patients to eligible trials.
Search ClinicalTrials.gov: find studies, retrieve results, match patients to candidate trials.
BioMCP: Biomedical Model Context Protocol
Control FL Studio with Claude: in-DAW mixing, diagnosis, routing, and composition.
MCP Security Weekly
Get CVE alerts and security updates for io.github.Dtsiakas/running-companion and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
My personal running and health dashboard, built on Garmin's read-only Personal API. It runs on my Windows laptop: the Garmin key and the database stay there. Claude can read the data through the app's MCP connector. Races, predictions and training plans stay in Garmin Connect.
This is a personal project. It isn't set up or supported for anyone else.
Running-Companion-Setup-<version>.exe from the latest release
and run it. It brings its own Node and needs no administrator rights. Windows warns about an unsigned installer the
first time: More info → Run anyway.%LOCALAPPDATA%\Running Companion\data. Installing a new version or uninstalling never touches it.desktop.json next to the
data folder; delete that file to be asked again.https://<machine>.ts.net/mcp). Add it in Claude as a
custom connector and approve it with the password.data\backups, automatic. To restore: close the app, then from a clone run
npm run restore -- <file> with COMPANION_DATA_DIR pointing at the data folder.Node 26 (it runs the TypeScript directly).
| Command | What it does |
|---|---|
npm run demo | The app on generated data at http://localhost:8788: no key, no login |
npm start | The server on http://localhost:8787 with data in data/ |
npm run dev:web | The dashboard with instant reload, proxying /api to npm start |
npm run build | Builds the dashboard |
npm run sync, npm run metrics | Sync from Garmin; recompute metrics (--full for everything) |
npm run backup, npm run restore -- <file> | Back up or restore the data folder |
npm run set-password | New login password |
npm test, npm run typecheck | Tests (synthetic data only) and types |
Releasing: put the notes under a new version in CHANGELOG.md, set that version in every package.json, push,
then publish a release with tag v<version> on GitHub. CI builds the installer, installs, starts and uninstalls it
on Windows, and attaches it to the release.
packages/metrics/src and in the MCP tool describe_data.
Thresholds (LTHR, max and resting HR) come from the latest Garmin profile.Copyright (C) 2026 Dimitris Tsiakas. AGPL-3.0-or-later, see LICENSE.
Not affiliated with Garmin. Not medical advice.