musclesworked-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@musclesworked-mcp Analyze my push day: bench press, overhead press, and tricep pushdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 primary, secondary, and stabilizer muscles for an exercise |
| Find exercises targeting a specific muscle with optional filters |
| Analyze a workout for coverage, gaps, and imbalances |
| Find alternative exercises ranked by muscle overlap |
| Search exercises by name to discover IDs |
| 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 (or set |
| Override base URL (default: |
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.jsLicense
MIT
Available Tools
6 toolsanalyze_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Exercise API MCP: 1,900+ exercises with video, workout generator, supplements, dev tools.
Fitness MCP for coaches and gyms: build workouts and read clients' training from live Superset data.
Adaptive running coach MCP server — training data, plans, and recovery for AI assistants.
MCP server exposing supplements database used by iNutriPlan.com
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceThis 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-
- AlicenseNot gradedqualityDmaintenanceAn 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 npm1MIT
- AlicenseNot gradedqualityDmaintenanceA 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
- FlicenseBqualityCmaintenanceA 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-