Hevy – #1 Workout Tracker & Planner Gym Log App

Hevy MCP - Connect Hevy to Your AI Assistant

Hevy’s MCP lets you connect your Hevy account to ChatGPT and Claude to read your training history and create or update routines. You can disconnect your Hevy account at any time. No technical knowledge needed.

How to Connect Hevy to Your AI Assistant via MCP

Assistant

Status

How to connect

ChatGPT

Available

Hevy for ChatGPT setup guide.

Claude

Available

Hevy for Claude setup guide.

Gemini, Grok & Muse

Available

Connect through our MCP*

*Learn how to manually connect your preferred AI assistant to Hevy through our MCP.

ChatGPT

  1. Open the Hevy for ChatGPT setup guide and follow the steps to add the Hevy plugin.
  2. Sign in with your Hevy account and approve access.
  3. In any ChatGPT conversation, type @hevy to bring Hevy in.
  4. Ask about your training or request a workout, for example: @hevy, build me a push/pull/legs plan with adjustable dumbbells and save it to Hevy.

To disconnect, remove the connection from ChatGPT’s settings.

screenshots displaying the Hevy plugin on ChatGPT and how users can start a new chat

Claude

  1. Open the Claude setup guide and follow the steps to set up the Hevy connector.
  2. Sign in with your Hevy app credentials and approve access.
  3. Start a new Claude chat and include “Use Hevy” or “Use the Hevy connector”.
  4. Ask Claude to analyze your workouts, performance, and progress, build you a new workout plan, or simply create one workout.

Developers

Building your own tool with Hevy data? Use the Hevy public API instead. See the API docs.

You can also check out our MCP documentation. It explains how you can use our MCP to connect your Hevy account to your preferred LLM, even if we don’t have an official integration yet.

What Can an AI Plugin or Connector Do With Hevy?

Once you connect your account, your assistant can:

  • Read your training history, so it can answer questions about your workouts, progress, and trends
  • Generate a workout or program, accounting for details like available equipment, limitations, preferences, and goals
  • Automatically create custom exercises if Hevy’s library lacks a certain movement needed for the training plan
  • Update routines you already have saved in your profile
  • Save routines to your Hevy account, so a plan you build in conversation is ready to follow in the app

Hevy doesn’t control the answers you get from AI. They depend on the length and detail of your prompt. Hevy only supports the integration and passes the result to your profile. Always check the end result and use your best judgment before following any workout guidance.

Example Prompts

Use case

Prompt

Starting out

I’m new to lifting and can train 3 days a week with a basic gym. Build me a routine and save it to Hevy.

Training at home

I only have adjustable dumbbells, a bench, and a pull-up bar. Build me a push/pull/legs plan.

Breaking a plateau

Look at my last 6 months of bench press and tell me where I stalled and what to change.

Planning the next session

Based on my last 5 workouts, what should I do tomorrow, and with what weights?

Coming back after a break

I haven’t trained in 8 weeks. Look at what I was lifting and ease me back in.

Balancing your training

Am I training back as much as chest? Suggest changes to my split.

Best Practices

Here are a few things to always keep in mind:

  • Give relevant details like injuries, nagging aches, general preferences, preferred workout frequency, and goals.
  • Continue to log in Hevy. That way, any AI tool you use will have increasingly more context and would be better able to guide you moving forward.
  • Use suggestions as a starting point. Review a routine before you follow it, and adjust anything that doesn’t fit how you train. Hevy gives you all the flexibility you need to design workouts that make 100% sense in your situation.

Other Ways to Use Hevy With AI

If you don’t want to use a full AI integration and instead prefer to only share some workout data, you also have:

  • Send to AI. Once finished with your workout, Hevy lets you share it in several ways, including by sending it directly to Claude or ChatGPT for analysis, feedback, and advice.
  • Copy Text. This is another option. Selecting this option allows you to copy all of the details of the workout and paste it into a new or existing chat in the AI assistant you use.
3 screenshots displaying some of the common ways to share a completed Hevy workout: copy text, send to AI, share on social media, and generate a workout link

You can also use the Hevy public API. This option is for developers who want to build their own tools with their Hevy data. See the API docs.

You Are in Control

  • You connect by signing in with your Hevy account and approving access
  • The assistant only gets the access you approve
  • You can remove the connection at any time from the assistant’s settings

FAQs

1. What is MCP?

MCP stands for Model Context Protocol, an agreed way for AI assistants and apps to talk to each other. Instead of building a different connection for every assistant, Hevy built one that follows the standard. It runs behind the scenes and powers the official integrations.

2. Do I need technical knowledge to use this?

No. Connect Hevy to your preferred AI tool, give it access, and start chatting.

3. Is it free?

The Hevy plugin for ChatGPT and Hevy connector for Claude work with free Hevy and free ChatGPT/Claude accounts.

4. What’s the difference between MCP and a plugin or connector?

The plugin or connector is what you see and use inside your assistant. MCP is the connection behind it.

5. Can I connect any AI tool to Hevy?

MCP currently powers our ChatGPT and Claude integrations. If you’re a developer who wants to build with your Hevy data, the public API is the best place to start. Our MCP documentation also explains how to link your Hevy account to other LLMs.