# Garmin MCP Server for Poke

A [Poke](https://poke.com)-compatible MCP server exposing 90+ [Garmin Connect](https://connect.garmin.com) tools over HTTP via [FastMCP](https://github.com/jlowin/fastmcp). Deployable to Render.

Built on top of [Taxuspt/garmin_mcp](https://github.com/Taxuspt/garmin_mcp) and [InteractionCo/mcp-server-template](https://github.com/InteractionCo/mcp-server-template).

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/theol0403/garmin-mcp-poke)

## Setup

### 1. Generate OAuth Tokens

Garmin accounts with MFA require local token generation:

```bash
pip install garminconnect garth
python scripts/generate_tokens.py
```

This will prompt for your Garmin email, password, and MFA code, then output a base64 token string.

### 2. Deploy to Render

#### Option 1: One-Click Deploy
Click the "Deploy to Render" button above, then set `GARMINTOKENS_BASE64` to the token string from step 1.

#### Option 2: Manual Deployment
1. Fork this repository
2. Connect your GitHub account to Render
3. Create a new Web Service on Render
4. Connect your forked repository
5. Render will automatically detect the `render.yaml` configuration
6. Set `GARMINTOKENS_BASE64` in environment variables

Your server will be available at `https://your-service-name.onrender.com/mcp`

### 3. Connect Poke

Add your Render URL to Poke at [poke.com/settings/connections](https://poke.com/settings/connections):
```
https://your-service-name.onrender.com/mcp
```

## Local Development

```bash
pip install -r requirements.txt
cp .env.example .env
# Edit .env and set GARMINTOKENS_BASE64
python src/server.py
```

Test with MCP Inspector:
```bash
npx @modelcontextprotocol/inspector
```
Open http://localhost:3000 and connect to `http://localhost:8000/mcp` using "Streamable HTTP" transport.

## Token Refresh

Tokens last approximately 6 months. When they expire, re-run `generate_tokens.py` and update the Render env var.

## Tool Categories

| Category | Tools | Examples |
|----------|-------|---------|
| Activity Management | 14 | Activities by date, splits, weather, HR zones, gear |
| Health & Wellness | 28 | Stats, sleep, stress, body battery, HRV, SpO2, steps |
| Training | 10 | Training status, endurance score, hill score, lactate threshold |
| User Profile | 4 | Profile info, settings, unit system |
| Devices | 7 | Device list, settings, alarms, solar data |
| Gear Management | 3 | Gear inventory, add/remove gear from activities |
| Weight Management | 5 | Weigh-ins, add/delete measurements |
| Challenges | 10 | Goals, badges, challenges, race predictions, PRs |
| Workouts | 7 | Workout library, scheduling, training plans, upload |
| Data Management | 3 | Body composition, blood pressure, hydration |
| Women's Health | 3 | Pregnancy, menstrual cycle tracking |
| Workout Templates | 5 | Resources with workout JSON templates |

## Attribution

Built on top of:
- [Taxuspt/garmin_mcp](https://github.com/Taxuspt/garmin_mcp) -- Garmin Connect MCP tool modules and authentication flow
- [InteractionCo/mcp-server-template](https://github.com/InteractionCo/mcp-server-template) -- FastMCP HTTP server template for Render/Poke