Garmin Mcp

Garmin Mcp

By Taxuspt GitHub

Allows clients like Claude Desktop to access your Garmin data

garmin fitness
Overview

what is Garmin MCP?

Garmin MCP is a Model Context Protocol server that connects to Garmin Connect, allowing clients like Claude Desktop to access and interact with your fitness and health data.

how to use Garmin MCP?

To use Garmin MCP, set up the server by installing the required packages, configuring your Garmin credentials in a .env file, and integrating it with Claude Desktop or MCP Inspector.

key features of Garmin MCP?

  • List recent activities
  • Get detailed activity information
  • Access health metrics such as steps, heart rate, and sleep
  • View body composition data

use cases of Garmin MCP?

  1. Tracking and analyzing fitness activities
  2. Monitoring health metrics over time
  3. Integrating fitness data with AI assistants for personalized insights

FAQ from Garmin MCP?

  • Is my data secure with Garmin MCP?

Yes, but ensure your .env file with credentials is kept secure and not shared.

  • Can I use Garmin MCP with other clients?

Yes, it is compatible with any MCP-compatible client, not just Claude Desktop.

  • What should I do if I encounter login issues?

Verify your credentials in the .env file, check for additional verification from Garmin Connect, and ensure the garminconnect package is up to date.

Content

# Garmin MCP Server

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.

Features

  • List recent activities
  • Get detailed activity information
  • Access health metrics (steps, heart rate, sleep)
  • View body composition data

Setup

  1. Install the required packages on a new environment:

```bash virtualenv .venv source .venv/bin/activate python -m pip install -r requirements.txt ```

  1. Create a `.env` file in the project root with your Garmin credentials:

``` GARMIN_EMAIL=your.email@example.com GARMIN_PASSWORD=your-password ```

Running the Server

With Claude Desktop

  1. Create a configuration in Claude Desktop:

Edit your Claude Desktop configuration file:

  • macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  • Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Add this server configuration:

```json { "mcpServers": { "garmin": { "command": "python", // if you created a new environment this should be "/.venv/bin/python" "args": ["/garmin_mcp/garmin_mcp_server.py"] } } } ```

Replace the path with the absolute path to your server file.

  1. Restart Claude Desktop

With MCP Inspector

For testing, you can use the MCP Inspector:

```bash npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py ```

Usage Examples

Once connected in Claude, you can ask questions like:

  • "Show me my recent activities"
  • "What was my sleep like last night?"
  • "How many steps did I take yesterday?"
  • "Show me the details of my latest run"

Security Note

This server requires your Garmin Connect credentials in the `.env` file. Keep this file secure and never commit it to a repository.

Troubleshooting

If you encounter login issues:

  1. Verify your credentials in the `.env` file are correct
  2. Check if Garmin Connect requires additional verification
  3. Ensure the garminconnect package is up to date

For other issues, check the Claude Desktop logs at:

  • macOS: `~/Library/Logs/Claude/mcp-server-garmin.log`
  • Windows: `%APPDATA%\Claude\logs\mcp-server-garmin.log`
No tools information available.
No content found.