garth-mcp-server


Namegarth-mcp-server JSON
Version 0.0.8 PyPI version JSON
download
home_pageNone
SummaryGarmin Connect MCP server
upload_time2025-08-19 01:09:28
maintainerNone
docs_urlNone
authorNone
requires_python>=3.13
licenseMIT
keywords garmin garmin connect mcp
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # garth-mcp-server

[![PyPI version](
    https://img.shields.io/pypi/v/garth-mcp-server.svg?logo=python&logoColor=brightgreen&color=brightgreen)](
    https://pypi.org/project/garth-mcp-server/)

Garmin Connect MCP server based on [garth](https://github.com/matin/garth).

## Usage

![image](https://github.com/user-attachments/assets/14221e6f-5f65-4c21-bc7a-2147c1c9efc1)

## Install

```json
{
  "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`.

## 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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "garth-mcp-server",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.13",
    "maintainer_email": null,
    "keywords": "garmin, garmin connect, mcp",
    "author": null,
    "author_email": "Matin Tamizi <mtamizi@duck.com>",
    "download_url": "https://files.pythonhosted.org/packages/b4/07/135817f0f2e911b8725f0c88d6e1a55723d7738225980e310e90491d37ed/garth_mcp_server-0.0.8.tar.gz",
    "platform": null,
    "description": "# garth-mcp-server\n\n[![PyPI version](\n    https://img.shields.io/pypi/v/garth-mcp-server.svg?logo=python&logoColor=brightgreen&color=brightgreen)](\n    https://pypi.org/project/garth-mcp-server/)\n\nGarmin Connect MCP server based on [garth](https://github.com/matin/garth).\n\n## Usage\n\n![image](https://github.com/user-attachments/assets/14221e6f-5f65-4c21-bc7a-2147c1c9efc1)\n\n## Install\n\n```json\n{\n  \"mcpServers\": {\n    \"Garth - Garmin Connect\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"garth-mcp-server\"\n      ],\n      \"env\": {\n        \"GARTH_TOKEN\": \"<output of `uvx garth login`>\"\n      }\n    }\n  }\n}\n```\n\nMake sure the path for the `uvx` command is fully scoped as MCP doesn't\nuse the same PATH your shell does. On macOS, it's typically\n`/Users/{user}/.local/bin/uvx`.\n\n## Tools\n\n### Health & Wellness (using Garth data classes)\n\n- `user_profile` - Get user profile information\n- `user_settings` - Get user settings and preferences\n- `nightly_sleep` - Get detailed sleep data with optional movement data\n- `daily_sleep` - Get daily sleep summary data\n- `daily_stress` / `weekly_stress` - Get stress data\n- `daily_intensity_minutes` / `weekly_intensity_minutes` - Get intensity minutes\n- `daily_body_battery` - Get body battery data\n- `daily_hydration` - Get hydration data\n- `daily_steps` / `weekly_steps` - Get steps data\n- `daily_hrv` / `hrv_data` - Get heart rate variability data\n\n### Activities (using Garmin Connect API)\n\n- `get_activities` - Get list of activities with optional filters\n- `get_activities_by_date` - Get activities for a specific date\n- `get_activity_details` - Get detailed activity information\n- `get_activity_splits` - Get activity lap/split data\n- `get_activity_weather` - Get weather data for activities\n\n### Additional Health Data (using Garmin Connect API)\n\n- `get_body_composition` - Get body composition data\n- `get_respiration_data` - Get respiration data\n- `get_spo2_data` - Get SpO2 (blood oxygen) data\n- `get_blood_pressure` - Get blood pressure readings\n\n### Device & Gear (using Garmin Connect API)\n\n- `get_devices` - Get connected devices\n- `get_device_settings` - Get device settings\n- `get_gear` - Get gear information\n- `get_gear_stats` - Get gear usage statistics\n\n### Utility Tools\n\n- `monthly_activity_summary` - Get monthly activity overview\n- `snapshot` - Get snapshot data for date ranges\n- `get_connectapi_endpoint` - Direct access to any Garmin Connect API endpoint\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Garmin Connect MCP server",
    "version": "0.0.8",
    "project_urls": null,
    "split_keywords": [
        "garmin",
        " garmin connect",
        " mcp"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "e2176dbad08c978d136863f3dc0a4dc961f605406e445a83b5c8f334cb6800ec",
                "md5": "d2282fa2aa940ee3ff50fd0d5c96d205",
                "sha256": "a94f71e7c51440212c70dc160d076432723dcad8d1d890d5a3c866e17ec0c3d0"
            },
            "downloads": -1,
            "filename": "garth_mcp_server-0.0.8-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d2282fa2aa940ee3ff50fd0d5c96d205",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.13",
            "size": 5522,
            "upload_time": "2025-08-19T01:09:27",
            "upload_time_iso_8601": "2025-08-19T01:09:27.262574Z",
            "url": "https://files.pythonhosted.org/packages/e2/17/6dbad08c978d136863f3dc0a4dc961f605406e445a83b5c8f334cb6800ec/garth_mcp_server-0.0.8-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b407135817f0f2e911b8725f0c88d6e1a55723d7738225980e310e90491d37ed",
                "md5": "ad6007b27f719cf8b2867cd0d5f1ff94",
                "sha256": "4c9b24ac327d79679c8581e9c8c23739a18827d6ea6dea3e5aeb3809507d39dc"
            },
            "downloads": -1,
            "filename": "garth_mcp_server-0.0.8.tar.gz",
            "has_sig": false,
            "md5_digest": "ad6007b27f719cf8b2867cd0d5f1ff94",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.13",
            "size": 34709,
            "upload_time": "2025-08-19T01:09:28",
            "upload_time_iso_8601": "2025-08-19T01:09:28.779560Z",
            "url": "https://files.pythonhosted.org/packages/b4/07/135817f0f2e911b8725f0c88d6e1a55723d7738225980e310e90491d37ed/garth_mcp_server-0.0.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-19 01:09:28",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "garth-mcp-server"
}
        
Elapsed time: 1.60733s