Garmin Health MCP Server

# Quick Start: Claude Code CLI Get up and running with the Garmin Health MCP Server in Claude Code in under 5 minutes. ## Prerequisites Check ```bash # Verify installations node --version # Should be 18+ python --version # Should be 3.8+ claude --version # Claude Code CLI installed ``` ## Setup (4 steps) ### 1. Install Dependencies ```bash cd D:\garmin-health-mcp-server npm install pip3 install garminconnect fitparse gpxpy ``` ### 2. Set Environment Variables **Windows (PowerShell as Administrator)**: ```powershell setx GARMIN_EMAIL "your-email@example.com" setx GARMIN_PASSWORD "your-password" ``` **Linux/macOS**: ```bash # Add to ~/.bashrc or ~/.zshrc export GARMIN_EMAIL="your-email@example.com" export GARMIN_PASSWORD="your-password" # Reload shell source ~/.bashrc ``` **Important**: Restart your terminal after setting environment variables! ### 3. Authenticate with Garmin ```bash npm run auth ``` Expected output: ``` 🔐 Logging in as your-email@example.com... ✅ Tokens saved to D:\garmin-health-mcp-server\.garmin-tokens ✅ Login successful! ``` ### 4. Test in Claude Code ```bash # Start Claude Code claude # Check MCP servers /mcp # Ask about your health "How did I sleep last night?" ``` ## That's it! 🎉 The `.mcp.json` file in this repository is already configured for you. ## Sample Queries Try asking Claude: - "What's my body battery level today?" - "Show me my HRV trend this week" - "List my activities from the past 7 days" - "How did I sleep compared to last week?" - "What's my average resting heart rate?" - "Generate a sleep dashboard for the past month" ## Troubleshooting **"Environment variables not set"** - Verify: `echo %GARMIN_EMAIL%` (Windows) or `echo $GARMIN_EMAIL` (Linux/macOS) - Make sure you restarted your terminal **"MCP server not found"** - Update path in `.mcp.json` to match your installation location - Make sure you're running `claude` from within the project directory **"Authentication failed"** - Verify credentials are correct - Try logging into https://connect.garmin.com - Run `npm run auth` again ## Need More Help? - **Detailed setup**: See [CLAUDE_CODE_SETUP.md](CLAUDE_CODE_SETUP.md) - **Installation guide**: See [INSTALL.md](INSTALL.md) - **Full documentation**: See [README.md](README.md) ## What Changed? This server now stores authentication tokens locally in `.garmin-tokens/` instead of requiring Clawdbot. This makes it work seamlessly with: - ✅ Claude Code CLI - ✅ Claude Desktop - ✅ Clawdbot (if installed) All three can share the same authentication tokens!