garmin-mcp-server 0.1.1__tar.gz

garmin_mcp_server-0.1.1/.env.example

@@ -0,0 +1,34 @@
+# ---------------------------------------------------------------------------
+# Garmin Connect MCP server configuration
+# ---------------------------------------------------------------------------
+# Copy this file to ".env" and fill in your values. The ".env" file is
+# git-ignored and will NEVER be committed.
+#
+#   cp .env.example .env
+#
+# RECOMMENDED: do NOT store your password here. Instead run the one-time
+# interactive login which handles MFA and caches OAuth tokens locally:
+#
+#   garmin-mcp-login
+#
+# After that, the server logs in using the cached tokens only — no password
+# is ever needed at runtime.
+# ---------------------------------------------------------------------------
+
+# Your Garmin Connect account email (only needed for the initial login).
+GARMIN_EMAIL=
+
+# Your Garmin Connect password (optional; prefer token-based auth above).
+# If your account has MFA enabled, password-only login will fail in the
+# server context — use `garmin-mcp-login` instead.
+GARMIN_PASSWORD=
+
+# Directory where OAuth tokens are cached (garth token store).
+# Defaults to ~/.garminconnect when unset. GARMIN_TOKEN_DIR is also accepted.
+GARMINTOKENS=~/.garminconnect
+
+# Set to "true" if your account is registered on garmin.cn (China).
+GARMIN_IS_CN=false
+
+# Optional: logging verbosity for the server (DEBUG, INFO, WARNING, ERROR).
+GARMIN_MCP_LOG_LEVEL=INFO

garmin_mcp_server-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      # Create a venv pinned to the matrix Python. Without this, `uv pip
+      # install --system` would target the runner's system interpreter and
+      # ignore the matrix version entirely.
+      - name: Create virtual environment
+        run: uv venv --python ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: uv run ruff check garmin_mcp tests
+
+      - name: Test (pytest)
+        run: uv run pytest

garmin_mcp_server-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,121 @@
+name: Release
+
+# On a version tag (e.g. v0.1.0):
+#   1. lint + test + build sdist/wheel,
+#   2. publish a GitHub Release with auto-generated notes + artifacts,
+#   3. publish to PyPI via Trusted Publishing (OIDC - no API tokens stored).
+#
+#   git tag -a v0.1.0 -m "v0.1.0"
+#   git push origin v0.1.0
+#
+# One-time PyPI setup (see README "Releasing"): register this repo + the
+# "pypi" environment as a Trusted Publisher at
+# https://pypi.org/manage/account/publishing/
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build & test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # create the GitHub Release
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history so we can diff against the previous tag
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Create virtual environment
+        run: uv venv --python 3.12
+
+      - name: Install project (with dev extras)
+        run: uv pip install -e ".[dev]" build
+
+      - name: Lint
+        run: uv run ruff check garmin_mcp tests
+
+      - name: Test
+        run: uv run pytest
+
+      - name: Build sdist and wheel
+        run: uv run python -m build
+
+      - name: Verify version matches the tag
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG="$(uv run python -c 'import garmin_mcp; print(garmin_mcp.__version__)')"
+          echo "tag=$TAG package=$PKG"
+          if [ "$TAG" != "$PKG" ]; then
+            echo "::error::Tag ($TAG) does not match package version ($PKG)"
+            exit 1
+          fi
+
+      - name: Generate release notes
+        run: |
+          set -euo pipefail
+          CURRENT="${GITHUB_REF_NAME}"
+          PREV="$(git describe --tags --abbrev=0 "${CURRENT}^" 2>/dev/null || true)"
+          {
+            echo "## What's changed in ${CURRENT}"
+            echo
+            if [ -n "$PREV" ]; then
+              echo "Changes since ${PREV}:"
+              echo
+              git log --pretty=format:'- %s (%h)' "${PREV}..${CURRENT}"
+              echo
+              echo
+              echo "**Full diff:** https://github.com/${GITHUB_REPOSITORY}/compare/${PREV}...${CURRENT}"
+            else
+              echo "First release."
+              echo
+              git log --pretty=format:'- %s (%h)'
+            fi
+          } > RELEASE_NOTES.md
+          echo "Generated release notes:"
+          cat RELEASE_NOTES.md
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+      - name: Publish GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: RELEASE_NOTES.md
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+          fail_on_unmatched_files: true
+
+  pypi-publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/garmin-mcp-server
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          # Attestations require OIDC (id-token: write); disable them when
+          # authenticating with an API token instead of Trusted Publishing.
+          attestations: false

garmin_mcp_server-0.1.1/.gitignore

@@ -0,0 +1,88 @@
+# ---------------------------------------------------------------------------
+# SECURITY: never commit credentials or Garmin auth tokens
+# ---------------------------------------------------------------------------
+.env
+.env.*
+!.env.example
+*.env
+secrets.*
+credentials.*
+
+# Garmin Connect OAuth token stores (garth dumps oauth1/oauth2 tokens here)
+.garminconnect/
+.garth/
+tokens/
+*.garth
+oauth1_token.json
+oauth2_token.json
+garmin_tokens/
+
+# Downloaded activity files (may contain GPS / personal data)
+downloads/
+*.fit
+*.tcx
+*.gpx
+*.zip
+
+# ---------------------------------------------------------------------------
+# Python
+# ---------------------------------------------------------------------------
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+.python-version
+
+# Test / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.cache/
+
+# Type checkers / linters
+.mypy_cache/
+.dmypy.json
+.ruff_cache/
+.pyright/
+
+# IDE / editor
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+*.log
+
+# Local tooling / agent artifacts (not part of the project)
+.claude/
+.tldr/
+.tldrignore

garmin_mcp_server-0.1.1/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Fixed
+- **Auth for garminconnect 0.3.2.** Authentication now delegates entirely to
+  garminconnect's own `login(tokenstore)`, which natively loads/refreshes
+  Garmin DI session tokens (the `{di_token, di_refresh_token, di_client_id}`
+  mobile token format), a token directory, or email/password — and persists
+  fresh tokens. Removes the obsolete `.garth` attribute access that broke on
+  0.3.2. `garmin-mcp-login` now uses garminconnect's `prompt_mfa` flow.
+  Verified live against a real account (curated + auto-exposed tools).
+
+### Added
+- **Full garminconnect 0.3.2 API coverage.** In addition to the 48 curated
+  tools, every remaining public `garminconnect` method is now auto-registered as
+  a tool at startup (endurance score, intensity minutes, weekly steps/stress,
+  FTP, lactate threshold, running tolerance, nutrition, golf, gear stats,
+  scheduled workouts, training plans, badge challenges, and all write/upload/
+  delete actions). The set stays in sync with the library automatically — new
+  methods become tools on upgrade.
+
+## [0.1.0] - 2026-05-31
+
+### Added
+- Initial release of the Garmin Connect MCP server.
+- 48 MCP tools spanning:
+  - **Profile & devices** — user profile, units, registered devices.
+  - **Daily health** — daily summary, steps, floors, heart rate, resting HR.
+  - **Wellness** — sleep, stress, Body Battery, SpO₂, respiration, HRV,
+    hydration, blood pressure.
+  - **Training** — readiness, status, VO₂max, fitness age, race predictions,
+    Hill Score, progress summary.
+  - **Activities** — list/by-date, summary, details, splits, weather, HR zones,
+    rename, download (FIT/TCX/GPX/CSV/KML), count.
+  - **Body** — body composition, weigh-ins, add weigh-in.
+  - **Records & more** — personal records, goals, badges, gear, workouts,
+    menstrual data, and a raw `connect_api` passthrough.
+- Token-based authentication with MFA support via a one-time `garmin-mcp-login`.
+- Resilient client: lazy auth, thread-safe, transparent re-authentication on
+  session expiry, friendly date inputs (`today`/`yesterday`/`-7`/ISO).
+- Automatic trimming of large time-series payloads to stay context-friendly.
+- Unit-test suite (mocked, offline) and a live integration script.
+- GitHub Actions CI (lint + tests across Python 3.10–3.12) and a tag-driven
+  release workflow that builds artifacts and publishes auto-generated notes.
+
+[Unreleased]: https://github.com/stitrace/garmin-mcp-server/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/stitrace/garmin-mcp-server/releases/tag/v0.1.0

garmin_mcp_server-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stitrace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.