← garmlink

Connect Garmin to Windsurf

Set up garmlink in

Windsurf's Cascade agent reaches garmlink as a remote MCP server. One entry in its MCP configuration, one sign-in, and Cascade answers from your real, synced Garmin history.

Before you start You need a garmlink account with your Garmin connected (do that on the Connection screen), and Windsurf installed. On a Teams or Enterprise plan, an admin may have to allow garmlink's address first.

  1. Connect your Garmin account

    On the Connection screen, sign in to Garmin Connect with your email and password (used once, never stored), complete the verification code if Garmin asks for one, and wait for the status to turn Connected. garmlink starts syncing your activities, sleep, HRV and training metrics right away.

  2. Add garmlink to Windsurf

    From the MCP menu of the Cascade panel, open the raw configuration — usually ~/.codeium/windsurf/mcp_config.json — and add garmlink:

    {
  "mcpServers": {
    "garmlink": {
      "serverUrl": "https://api.garmlink.ai/mcp"
    }
  }
}

    Save, then refresh the MCP list: garmlink shows among the servers.

  3. Sign in to garmlink

    garmlink then asks you to sign in: click Authenticate next to it. Your browser opens on garmlink: sign in, then press Authorize.

  4. Ask your first question

    Then ask in plain language, in the tool's chat or agent panel:
    • “How did I sleep this week?”
    • “Summarize my last five runs.”
    • “Is my training load trending up or down this month?”
Troubleshooting
  • garmlink is blocked. On a Teams or Enterprise plan, MCP servers can be limited to a list: ask your admin to allow garmlink's address.
  • It asks for an API key or a token. garmlink needs none: leave every key, header and client secret field empty. You sign in through your browser, with your garmlink account.
  • Data looks empty or stale. Check where the sync stands on the Connection screen.

Using another assistant? See all the setup guides. Curious what garmlink can read? Browse the tools reference. Want to see real answers first? Read twelve examples from a real account.