Skip to main content
Glama

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_..."
      }
    }
  }
}

Related MCP server: mcp-academia-server

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

Available Tools

6 tools
analyze_workoutB

Analyze a workout for muscle coverage, gaps, and imbalances. Pass a list of exercise names or IDs.

Inputs: exercises (required).

find_exercisesA

Find exercises that target a specific muscle, with optional filters. Use search_muscles first if you don't know the muscle ID.

Inputs: muscle (required), equipment, difficulty, movement_pattern, +3 more.

get_alternativesA

Find alternative exercises ranked by muscle overlap score. Use search_exercises first if you don't know the exercise ID.

Inputs: exercise (required), limit.

get_muscles_workedA

Get the primary, secondary, and stabilizer muscles worked by an exercise. Use search_exercises first if you don't know the exercise ID.

Inputs: exercise (required).

search_exercisesA

Search for exercises by name. Returns matching exercise IDs and names. Use this to discover exercise IDs before calling get_muscles_worked or get_alternatives.

Inputs: query (required).

search_musclesA

Search for muscles by name. Returns matching muscle IDs and names. Use this to discover muscle IDs before calling find_exercises.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: analyze_workout evaluates workouts, find_exercises locates exercises by muscle, get_alternatives suggests substitutes, get_muscles_worked details muscle involvement, search_exercises finds exercises by name, and search_muscles finds muscles by name. The descriptions explicitly differentiate their functions, preventing agent confusion.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case throughout (e.g., analyze_workout, find_exercises, get_muscles_worked). The naming is predictable and readable, using clear verbs like 'analyze', 'find', 'get', and 'search' that accurately reflect each tool's action.

    Tool Count5/5

    With 6 tools, this server is well-scoped for its fitness/bodybuilding domain. Each tool earns its place by covering key workflows: discovering muscles and exercises, analyzing muscle involvement, finding alternatives, and evaluating workouts. The count is neither too sparse nor bloated, fitting typical agent needs efficiently.

    Completeness4/5

    The tool set provides strong coverage for core muscle and exercise analysis tasks, including search, retrieval, and workout evaluation. A minor gap exists in update or management operations (e.g., no tools for creating or modifying exercise/muscle data), but this is reasonable for a lookup-oriented server, and agents can work around it with the provided tools.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      This MCP server enables the generation of structured fitness content, including detailed exercise instructions with image prompts, balanced daily workout sessions, and personalized multi-day training plans. It facilitates the creation of comprehensive workout programs tailored to specific goals, age ranges, and movement patterns.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server specialized in managing and querying gym exercises through a centralized database. It enables users to search for workouts by name or muscle group and retrieve detailed information including sets, repetitions, and rest intervals.
      2,530 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A unified MCP server that connects AI assistants to multiple fitness services (Hevy, Strava, Cronometer, Intervals.icu) through a single secure endpoint, enabling workout, nutrition, and activity data access.
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      A personal remote MCP server for fitness data that provides read-only tools to query Garmin Connect activities and Hevy workouts, enabling users to list, retrieve, and analyze exercise records through natural language.
      13
      -