← garmlinkDashboard

Set up garmlink in ChatGPT

garmlink connects to ChatGPT as a connector over the Model Context Protocol (MCP). Once linked, ChatGPT can answer questions about your own Garmin data, pulled from your synced history. This takes about two minutes.

Before you start

You need a garmlink account with your Garmin connected (do that on the Connection screen), and a paid ChatGPT plan with developer mode — connectors aren't available on the free tier. Everything garmlink exposes is read-only, with one exception: a rate-limited “refresh my sync” action.
1

Connect your Garmin account

On the Connection screen, enter your Garmin Connect credentials and complete the verification code if asked. Wait for the status to read Connected.
2

Enable developer mode in ChatGPT

Go to Settings → Apps & Connectors → Advanced → Developer mode and turn it on. This is what lets you add a custom MCP connector.
3

Fill in the “New connector” dialog

Open Settings → Apps & Connectors → Create. The two fields that trip people up are the URL (must end in /mcp) and Authentication (must be OAuth, not “No authentication”).
ChatGPT New connector dialog with every field labeled for garmlink: icon, name, description, server URL, OAuth authentication, and the risk-acknowledgement checkbox.
The “New connector” dialog, field by field — tap to open full-size.
  • Icon (optional) — PNG, 256×256, ≤ 10 KB. Use garmlink-icon-256.png.
  • Name — garmlink — just the label shown in ChatGPT.
  • Description (optional) — anything, e.g. “My Garmin training, sleep & recovery”.
  • Connection — choose Server URL (not Tunnel).
  • MCP server URL — it must end in /mcp:https://api.garmlink.ai/mcp
  • Authentication — select OAuth. Do NOT pick “No authentication” — garmlink returns a 401 challenge to start the OAuth sign-in, so “no auth” fails with “Error creating connector”.
  • I understand and want to continue — tick it — ChatGPT shows a generic risk notice for any custom MCP server.
  • Create — press it. ChatGPT then kicks off the OAuth flow (next step).
4

Approve access (OAuth)

ChatGPT sends you to garmlink. Sign in, then on the Authorize access screen press Authorize. ChatGPT returns you and the connector shows as connected. You can revoke access anytime by disconnecting from the Connection screen.
5

Ask your first question

In a new chat, make sure the garmlink connector is enabled for the conversation, then try:
  • “Am I ready for my half marathon in 6 weeks?”
  • “How has my HRV trended versus my sleep this month?”
  • “Which of my rides had the highest normalized power?”

Troubleshooting

  • “Error creating connector.” Almost always one of two things: the URL doesn't end in /mcp, or Authentication is set to “No authentication” instead of OAuth. Fix either and press Create again.
  • No connector / developer-mode option. Developer mode requires a paid plan and the web app — it isn't available in every client.
  • Data looks empty or stale. Ask ChatGPT to refresh the sync, or use Refresh on the Connection screen.
  • Reconnect needed. If your Garmin session expired, reconnect from the Connection screen.

Using Claude too? See the Claude setup guide. Browse every tool garmlink exposes in the MCP catalogue.