• VISUALS
  • TEXT
  • SEARCH
  • HUMAN

How to retrieve exercise instructions and gifs with your AI

Connect ExerciseDB to your AI client to access a massive library of movement data. Once connected, your agent pulls specific instructions and visuals on demand.

Ask AI about this page

Short answer

How can I get exercise instructions and GIFs through my AI?

Your AI uses the ExerciseDB connector to find specific exercises by name or ID. It then pulls the step-by-step text guides and GIF demonstrations for those movements. You get immediate visual and written instructions for your workouts.

The results you get

What your AI delivers

The connector turns your questions into actionable fitness data.

VISUALS

GIF demonstrations

The AI finds the specific GIF for a movement. You get a clear visual of the correct form.

TEXT

Step-by-step guides

Your agent retrieves the written instructions. This gives you the exact mechanics for every rep.

SEARCH

Exercise lookups

The AI searches the database for specific names. It finds the right movement even if you aren't sure of the exact term.

HUMAN

Form adjustment

The AI provides the data, but you decide if the movement feels right. You use the GIFs to check your own posture.

The workflow

What your AI does when you ask for an exercise.

The AI acts as a bridge between your chat and the ExerciseDB database.

  1. Identify the movement

    Your agent looks at your request and determines which exercise you are talking about.

    get_exercises_by_name
  2. Fetch specific details

    Once the exercise is identified, the AI pulls the full data package for that specific movement.

    get_exercise_by_id
  3. Extract visual assets

    The AI isolates the GIF URL from the data so it can show you the movement.

    get_exercise_by_id
  4. Deliver instructions

    The agent presents the written steps and the GIF in your chat interface.

    get_exercise_by_id

Try it

Copy these to start.

Use these prompts to trigger the ExerciseDB tools.

Starting points

Swap out the exercise names for whatever you are training today.

ExerciseDB Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Ni07nTHjsacXhWL1jWBEUso4C8np6uM1UxvA6hsF/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ExerciseDB capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "exercisedb-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Ni07nTHjsacXhWL1jWBEUso4C8np6uM1UxvA6hsF/mcp"
    }
  }
}
Copy into chat04
  • Show me a GIF and instructions for a Bulgarian Split Squat.

  • Find the movement guide for Bench Press.

  • Give me the step-by-step instructions for the Deadlift.

  • I need a visual for the Kettlebell Swing.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect ExerciseDB once, then ask.

Just click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start asking for exercises immediately.

Connect ExerciseDB to your AI

FAQ

How this task behaves

  • 01

    Can the AI create a custom workout plan for me?

    The AI can use the exercise data to suggest movements, but it doesn't have a tool to save or manage a persistent workout schedule.

  • 02

    Can I upload my own exercise videos?

    No. This connector only retrieves existing data from ExerciseDB. It cannot upload or host your own media.

  • 03

    Does the AI know if I am doing the move correctly?

    No. The AI provides the instructions and GIFs, but it cannot see you or analyze your real-time form.

  • 04

    Can the AI find exercises by muscle group?

    The current tools allow for searching by name or ID. It doesn't have a specific tool to filter by muscle group like 'chest' or 'quads'.

  • 05

    Will the AI change the instructions in the database?

    No. The tools are read-only. Your AI can only retrieve information, not edit the ExerciseDB content.

  • More questions about ExerciseDB? The Connector page answers them. See everything the ExerciseDB Connector can do

Connect ExerciseDB to Claude, Cursor, ChatGPT & more