Skip to main content

Garmin Connect MCP server

Project description

garth-mcp-server

PyPI version

Garmin Connect MCP server based on garth.

Usage

image

Install

{
  "mcpServers": {
    "Garth - Garmin Connect": {
      "command": "uvx",
      "args": [
        "garth-mcp-server"
      ],
      "env": {
        "GARTH_TOKEN": "<output of `uvx garth login`>"
      }
    }
  }
}

Make sure the path for the uvx command is fully scoped as MCP doesn't use the same PATH your shell does. On macOS, it's typically /Users/{user}/.local/bin/uvx.

Tool Filtering

By default, all 30 tools are exposed. To reduce context size for LLM usage, you can filter tools using environment variables.

Enable specific tools only (whitelist)

{
  "mcpServers": {
    "Garth - Garmin Connect": {
      "command": "uvx",
      "args": ["garth-mcp-server"],
      "env": {
        "GARTH_TOKEN": "<token>",
        "GARTH_ENABLED_TOOLS": "get_activities,get_activity_details,daily_steps,nightly_sleep"
      }
    }
  }
}

Disable specific tools (blacklist)

"env": {
  "GARTH_TOKEN": "<token>",
  "GARTH_DISABLED_TOOLS": "get_gear,get_gear_stats,get_device_settings,get_connectapi_endpoint"
}

Tool names are case-insensitive and comma-separated. If GARTH_ENABLED_TOOLS is set, GARTH_DISABLED_TOOLS is ignored.

Tools

Health & Wellness (using Garth data classes)

  • user_profile - Get user profile information
  • user_settings - Get user settings and preferences
  • nightly_sleep - Get detailed sleep data with optional movement data
  • daily_sleep - Get daily sleep summary data
  • daily_stress / weekly_stress - Get stress data
  • daily_intensity_minutes / weekly_intensity_minutes - Get intensity minutes
  • daily_body_battery - Get body battery data
  • daily_hydration - Get hydration data
  • daily_steps / weekly_steps - Get steps data
  • daily_hrv / hrv_data - Get heart rate variability data

Activities (using Garmin Connect API)

  • get_activities - Get list of activities with optional filters
  • get_activities_by_date - Get activities for a specific date
  • get_activity_details - Get detailed activity information
  • get_activity_splits - Get activity lap/split data
  • get_activity_weather - Get weather data for activities

Additional Health Data (using Garmin Connect API)

  • get_body_composition - Get body composition data
  • get_respiration_data - Get respiration data
  • get_spo2_data - Get SpO2 (blood oxygen) data
  • get_blood_pressure - Get blood pressure readings

Device & Gear (using Garmin Connect API)

  • get_devices - Get connected devices
  • get_device_settings - Get device settings
  • get_gear - Get gear information
  • get_gear_stats - Get gear usage statistics

Utility Tools

  • monthly_activity_summary - Get monthly activity overview
  • snapshot - Get snapshot data for date ranges
  • get_connectapi_endpoint - Direct access to any Garmin Connect API endpoint

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_matin_garth_mcp_server-0.0.10.tar.gz (36.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_matin_garth_mcp_server-0.0.10.tar.gz.

File metadata

  • Download URL: iflow_mcp_matin_garth_mcp_server-0.0.10.tar.gz
  • Upload date:
  • Size: 36.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_matin_garth_mcp_server-0.0.10.tar.gz
Algorithm Hash digest
SHA256 33a6264c66aca8f89b6e6d1cc3e17919aaf0ff22a84a8eb2a0fc15421ffae58f
MD5 0cb0fd5ede64ed13b5377ad1d8c1b7f2
BLAKE2b-256 89dfb19a66d2cd72c996724419ba766257098a2ab6c732ba2be5dc7290ae0064

See more details on using hashes here.

File details

Details for the file iflow_mcp_matin_garth_mcp_server-0.0.10-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_matin_garth_mcp_server-0.0.10-py3-none-any.whl
  • Upload date:
  • Size: 6.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_matin_garth_mcp_server-0.0.10-py3-none-any.whl
Algorithm Hash digest
SHA256 228832391d89ce7c4808431b13bfac4331694254ce7cb49bc3696a638583a25b
MD5 cdd67d2db276e90b8f3f521f31fadd19
BLAKE2b-256 d99e936f2d1922fb2a9723001155368fee512a4b43e3782cf3397e24246efaf6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page