MusclesWorked MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "MUSCLESWORKED_API_KEY=${MUSCLESWORKED_API_KEY}" musclesworked -- npx -y musclesworked-mcp
Required:MUSCLESWORKED_API_KEY+ 1 optional
README.md

MCP server for the musclesworked.com exercise-to-muscle mapping API.

musclesworked-mcp

MCP server for the musclesworked.com exercise-to-muscle mapping API.

Connects Claude Desktop, Claude Code, Cursor, and other MCP clients to 856 exercises and 65 muscles with detailed primary/secondary/stabilizer activation data across 14 muscle groups.

Setup

Get an API key at musclesworked.com/dashboard.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "musclesworked": {
      "command": "npx",
      "args": ["-y", "musclesworked-mcp"],
      "env": {
        "MUSCLESWORKED_API_KEY": "mw_live_..."
      }
    }
  }
}

Claude Code

claude mcp add musclesworked -- npx -y musclesworked-mcp --api-key mw_live_...

Or add to .mcp.json:

{
  "mcpServers": {
    "musclesworked": {
      "command": "npx",
      "args": ["-y", "musclesworked-mcp", "--api-key", "mw_live_..."]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "musclesworked": {
      "command": "npx",
      "args": ["-y", "musclesworked-mcp"],
      "env": {
        "MUSCLESWORKED_API_KEY": "mw_live_..."
      }
    }
  }
}

Tools

Tool Description
get_muscles_worked Get primary, secondary, and stabilizer muscles for an exercise
find_exercises Find exercises targeting a specific muscle with optional filters
analyze_workout Analyze a workout for coverage, gaps, and imbalances
get_alternatives Find alternative exercises ranked by muscle overlap
search_exercises Search exercises by name to discover IDs
search_muscles Search muscles by name to discover IDs

Example Prompts

  • "What muscles does the barbell bench press work?"
  • "Find bodyweight exercises for my chest"
  • "Analyze my push day: bench press, overhead press, tricep pushdown, lateral raise"
  • "What are some alternatives to barbell squats?"
  • "Search for exercises that target the hamstrings"

Configuration

Option Description
--api-key <key> API key (or set MUSCLESWORKED_API_KEY env var)
MUSCLESWORKED_API_URL Override base URL (default: https://musclesworked.com)

Development

git clone https://github.com/csjoblom/musclesworked-mcp.git
cd musclesworked-mcp
npm install
npm run build

# Test with MCP Inspector
MUSCLESWORKED_API_KEY=mw_live_... npx @modelcontextprotocol/inspector node dist/index.js

License

MIT

Tools (6)

get_muscles_workedGet primary, secondary, and stabilizer muscles for an exercise
find_exercisesFind exercises targeting a specific muscle with optional filters
analyze_workoutAnalyze a workout for coverage, gaps, and imbalances
get_alternativesFind alternative exercises ranked by muscle overlap
search_exercisesSearch exercises by name to discover IDs
search_musclesSearch muscles by name to discover IDs

Environment Variables

MUSCLESWORKED_API_KEYrequiredAPI key for accessing the musclesworked.com service
MUSCLESWORKED_API_URLOverride base URL for the API

Configuration

claude_desktop_config.json
{"mcpServers": {"musclesworked": {"command": "npx", "args": ["-y", "musclesworked-mcp"], "env": {"MUSCLESWORKED_API_KEY": "mw_live_..."}}}}

Try it

What muscles does the barbell bench press work?
Find bodyweight exercises for my chest
Analyze my push day: bench press, overhead press, tricep pushdown, lateral raise
What are some alternatives to barbell squats?
Search for exercises that target the hamstrings

Frequently Asked Questions

What are the key features of MusclesWorked?

Access to detailed exercise-to-muscle mapping for over 856 exercises. Primary, secondary, and stabilizer muscle activation data. Workout analysis for coverage, gaps, and imbalances. Exercise alternative discovery based on muscle overlap. Search functionality for exercises and muscle groups.

What can I use MusclesWorked for?

Designing balanced workout routines by identifying muscle gaps. Finding suitable exercise alternatives when equipment is unavailable. Learning the specific muscle activation patterns for new exercises. Auditing existing workout plans for over-training or under-training specific muscle groups.

How do I install MusclesWorked?

Install MusclesWorked by running: npx -y musclesworked-mcp

What MCP clients work with MusclesWorked?

MusclesWorked works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep MusclesWorked docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare