Put Your Garmin Inside Claude

Create your three free accounts

Open each link in a new tab and sign up. You'll come back to these.

1. GitHub — where the app's code lives. Sign up at github.com/signup.
2. Railway — the service that keeps your app running 24/7. Sign up at railway.com (choose "Login with GitHub" to make life easy).
3. Claude — where you'll talk to your data afterward, on the web at claude.ai or the Claude phone app. No desktop app is needed just to use it.

Copy the app to your own GitHub

The app is open-source and ready to go. "Forking" simply makes your own copy.

1. Go to the project: github.com/sumal009/garmin-mcp.
2. Click the Fork button (top-right). On the next screen, click Create fork.
3. Done — you now have your own copy at github.com/your-name/garmin-mcp.

Put it online with Railway

Railway takes your copy and runs it on the internet. All clicking, no typing.

1. In Railway, click New Project → Deploy from GitHub repo.
2. Pick your garmin-mcp fork. Railway starts building it automatically.
3. Wait for it to finish. It will show as "Crashed" or unhealthy — that is expected and safe. The app refuses to run until you give it your secret key (Step 5). We'll fix it in Step 7.

Add a small storage disk

This lets your app remember its Garmin login so you don't have to repeat it.

1. In Railway, click your service (the box named garmin-mcp).
2. Open the Settings (or right-click the service) and choose Add Volume → Attach Volume.
3. Set the Mount path to exactly:

/root/.garminconnect

Make your secret key (the lock on your data)

This long random word is the password that keeps everyone else out. Generate one and paste it somewhere safe (a notes app) for a few minutes — you'll use it twice.

Easiest way: open this generator and copy the word it shows. Or, if you're on a Mac/Linux terminal, run:

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

Get your Garmin "key" — once, on your own computer

This is the only step that uses your computer. It logs into Garmin from your home (so Garmin trusts it) and turns your login into a long safe code. Your password is typed on your own machine and never sent to us or to Railway.

On a Mac: open the Terminal app (press ⌘ + Space, type "Terminal", hit Enter). Paste this whole block and press Enter:

python3 -m venv /tmp/garmin-key && /tmp/garmin-key/bin/pip install -q "garminconnect==0.2.25"
cat > /tmp/getkey.py <<'PY'
import getpass
from garminconnect import Garmin
email = input("Garmin email: ").strip()
pw = getpass.getpass("Garmin password: ")
g = Garmin(email=email, password=pw, is_cn=False,
           prompt_mfa=lambda: input("Code from your email/SMS: ").strip())
g.login()
print("\n===== COPY THE ONE LONG LINE BELOW =====")
print(g.garth.dumps())
print("===== end =====")
PY
/tmp/garmin-key/bin/python /tmp/getkey.py

On Windows: install Python (tick "Add Python to PATH" during install). Open Notepad, paste the script below, and Save As getkey.py (change "Save as type" to All Files) onto your Desktop:

import getpass
from garminconnect import Garmin
email = input("Garmin email: ").strip()
pw = getpass.getpass("Garmin password: ")
g = Garmin(email=email, password=pw, is_cn=False,
           prompt_mfa=lambda: input("Code from your email/SMS: ").strip())
g.login()
print("\n===== COPY THE ONE LONG LINE BELOW =====")
print(g.garth.dumps())
print("===== end =====")

Then open PowerShell (Start menu → type "PowerShell") and run these two lines:

pip install garminconnect==0.2.25
python $HOME\Desktop\getkey.py

Either way, it asks for your email, then password, then a security code Garmin texts/emails you. When it finishes it prints one very long line between the ===== markers. Copy that entire long line and keep it safe for the next step — that's your Garmin key.

Give Railway your secrets, and switch it on

Back in Railway, open your garmin-mcp service and click the Variables tab. Add these four, one at a time (New Variable → name → value):

• MCP_ACCESS_TOKEN → your secret key from Step 5
• GARMIN_TOKEN_BASE64 → the long Garmin key from Step 6 (paste the whole line)
• GARMIN_MCP_TRANSPORT → streamable-http
• GARMIN_MCP_HOST → 0.0.0.0

Railway automatically re-deploys. This time it should turn green / Active — your app is alive. 🎉 Now give it a web address:

1. Open Settings → Networking (or "Public Networking").
2. Click Generate Domain. Railway shows a web address like garmin-mcp-production-xxxx.up.railway.app.
3. Copy that address — you'll need it in the last step. We'll call it YOUR-APP.

Connect it to Claude, and open your dashboard

You now have two web addresses. In both, replace YOUR-APP with your Railway address and YOUR-KEY with your secret key from Step 5.

1 · Add it to Claude — In Claude, go to Settings → Connectors → Add custom connector. Give it a name (e.g. "Garmin"), paste this as the URL, leave the OAuth boxes empty, and click Add:

https://YOUR-APP/mcp?token=YOUR-KEY

Now, in any chat, try: "What's my body battery and how did I sleep?" Claude will read your Garmin and answer.

2 · Open your dashboard — Paste this into your phone or laptop browser. Then use your browser's "Add to Home Screen" to get an app icon:

https://YOUR-APP/dashboard?token=YOUR-KEY

That's it — you're done. 🏁 Your Garmin now lives inside Claude, and your dashboard updates itself every time you open it.