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:

config.json

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

Claude Code

Terminal

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

Or add to .mcp.json:

config.json

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

Cursor

Add to .cursor/mcp.json:

config.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

bash

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