English Français العربية

MusclesWorked

Official registry Other

Exercise-to-muscle mapping: 856 exercises, 65 muscles, workout analysis & alternatives.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package musclesworked-mcp
Claude Code 
claude mcp add musclesworked -e 'MUSCLESWORKED_API_KEY=<your musclesworked_api_key>' -- npx -y musclesworked-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "musclesworked": {
            "command": "npx",
            "args": [
                "-y",
                "musclesworked-mcp@0.1.0"
            ],
            "env": {
                "MUSCLESWORKED_API_KEY": "<your musclesworked_api_key>"
            }
        }
    }
}

Environment variables

  • MUSCLESWORKED_API_KEY required secret Your MusclesWorked API key (get one at musclesworked.com/dashboard)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. musclesworked-mcp
  2. Setup
  3. Tools
  4. Example Prompts
  5. Configuration
  6. Development
  7. License

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

ToolDescription
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

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

OptionDescription
--api-key <key>API key (or set MUSCLESWORKED_API_KEY env var)
MUSCLESWORKED_API_URLOverride 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

Frequently asked questions

What is MusclesWorked?

Exercise-to-muscle mapping: 856 exercises, 65 muscles, workout analysis & alternatives.

How do I install MusclesWorked?

It runs on your machine. In Claude Code: claude mcp add musclesworked -e 'MUSCLESWORKED_API_KEY=<your musclesworked_api_key>' -- npx -y musclesworked-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does MusclesWorked need an API key?

Yes. It expects MUSCLESWORKED_API_KEY, which you set in its configuration.

Is MusclesWorked open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains MusclesWorked?

It is published by csjoblom. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.