Skip to content
Search articles

Hevy: connect, sync and troubleshoot

Updated

On this page

Bring your Hevy exercise log into freddy so sets, reps and weights can sit beside endurance sessions and sleep records.

Before you connect

Hevy API access requires Hevy Pro. Your freddy account and your Hevy subscription are separate.

Illustrative Hevy connection guide; synthetic example.

Connect

Open Sources in freddy

  1. Open Hevy’s Developer settings and copy your API key.
  2. In freddy Sources, choose Hevy and Connect. Paste the key into the API Key field and save.
  3. Return to the source and check the import progress, then compare a completed workout with your Hevy log.

What reaches freddy

  • Logged workouts, exercise names and detailed sets.
  • Reps, load and available set details from the workout record.
  • Body measurements where available in your Hevy account.

History and updates

freddy imports your available workout history and checks periodically for new or edited sessions. Save the session in Hevy first. A routine template is not the same as a completed workout.

If data is missing

  • The key is rejected: confirm Hevy Pro access and copy the current key without extra spaces.
  • A session is missing: finish and save it in Hevy, then use Sync in freddy.
  • A key stopped working after replacement: update the connection with the new key. Do not send API keys to your AI client or support chat.

Use it with your other sources

List my Hevy exercises, sets and reps this week beside my Garmin runs. Check for overlapping workout records.

Illustrative Hevy comparison with another source; synthetic example.

Pause or disconnect

Use Paused on the source to stop future sync without deleting its stored history. Disconnect removes the connection and its associated data from freddy; read the confirmation before continuing. It does not delete your records in Hevy. You can also revoke the key or API client in the source service’s settings.

Provider instructions

Find your Hevy API key

Hevy API access

Related help

Choose a source

Find missing data and understand sync

Contact freddy support

Use your Hevy data with your AI

Pick your AI for the setup steps and ideas for what to ask.

  • Claude Desktop
    On Claude Team and Enterprise, an Owner adds freddy for the organization first.
  • ChatGPT
  • OpenAI dots
    Availability depends on your OpenAI plan and region.
  • Grok Bot
  • Grok
  • Muse
  • Muse Code
  • Gemini
    Gemini's custom apps need Gemini Spark, which comes with Google AI Pro or Ultra, and are US and English only.
  • Gemini CLI
    Gemini CLI is a developer command-line tool, not the consumer Gemini app. The app connects separately and needs Gemini Spark.
  • Claude Code
  • Cursor
  • Codex
  • Perplexity
    Custom connectors require Perplexity Pro, Max, or Enterprise.
  • OpenClaw
  • Hermes Agent
  • Instinct
    Experimental. Instinct is invite only and does not publish steps for adding your own MCP server.
  • Hark
    Experimental. Hark does not document a way to add your own MCP server yet, so this may not work today.
  • the freddy CLI

freddy is an independent service and is not affiliated with, endorsed by, or sponsored by the makers of the third-party AI apps above.

← Back to Connect data sources

Need a hand?

Send the source name and the step you’re stuck on.

[email protected] ↗