← garmlink

Connect Garmin to Cursor

Set up garmlink in

Cursor reaches garmlink as a remote MCP server: one entry in its MCP configuration, then a sign-in in your browser. Its agent then answers from your real, synced Garmin history — handy to analyse your training next to your own scripts and notebooks.

Before you start You need a garmlink account with your Garmin connected (do that on the Connection screen), and Cursor installed on your computer.

  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 Cursor

    The quickest way is Cursor's own install link, which opens Cursor with garmlink filled in: Add garmlink to Cursor.

    Or by hand: open ~/.cursor/mcp.json (create it if it doesn't exist) and add garmlink:

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

    That file covers every project; for one project only, the same lines go in .cursor/mcp.json at its root.

  3. Sign in to garmlink

    Open Cursor's settings, MCP section: next to garmlink, click the button that asks you to sign in. Your browser opens on garmlink — sign in, then press Authorize. Back in Cursor, garmlink lists its tools.

  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 shows an error or no tools. Check that the address ends in /mcp and that the file is valid JSON — one missing comma silences the whole file — then turn garmlink off and on in the MCP settings.
  • 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.