Musclesworked MCP

1# musclesworked-mcp
2 
3MCP server for the [musclesworked.com](https://musclesworked.com) exercise-to-muscle mapping API.
4 
5Connects 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.
6 
7## Setup
8 
9Get an API key at [musclesworked.com/dashboard](https://musclesworked.com/dashboard).
10 
11### Claude Desktop
12 
13Add to your `claude_desktop_config.json`:
14 
15```json
16{
17  "mcpServers": {
18    "musclesworked": {
19      "command": "npx",
20      "args": ["-y", "musclesworked-mcp"],
21      "env": {
22        "MUSCLESWORKED_API_KEY": "mw_live_..."
23      }
24    }
25  }
26}
27```
28 
29### Claude Code
30 
31```bash
32claude mcp add musclesworked -- npx -y musclesworked-mcp --api-key mw_live_...
33```
34 
35Or add to `.mcp.json`:
36 
37```json
38{
39  "mcpServers": {
40    "musclesworked": {
41      "command": "npx",
42      "args": ["-y", "musclesworked-mcp", "--api-key", "mw_live_..."]
43    }
44  }
45}
46```
47 
48### Cursor
49 
50Add to `.cursor/mcp.json`:
51 
52```json
53{
54  "mcpServers": {
55    "musclesworked": {
56      "command": "npx",
57      "args": ["-y", "musclesworked-mcp"],
58      "env": {
59        "MUSCLESWORKED_API_KEY": "mw_live_..."
60      }
61    }
62  }
63}
64```
65 
66## Tools
67 
68| Tool | Description |
69|------|-------------|
70| `get_muscles_worked` | Get primary, secondary, and stabilizer muscles for an exercise |
71| `find_exercises` | Find exercises targeting a specific muscle with optional filters |
72| `analyze_workout` | Analyze a workout for coverage, gaps, and imbalances |
73| `get_alternatives` | Find alternative exercises ranked by muscle overlap |
74| `search_exercises` | Search exercises by name to discover IDs |
75| `search_muscles` | Search muscles by name to discover IDs |
76 
77## Example Prompts
78 
79- "What muscles does the barbell bench press work?"
80- "Find bodyweight exercises for my chest"
81- "Analyze my push day: bench press, overhead press, tricep pushdown, lateral raise"
82- "What are some alternatives to barbell squats?"
83- "Search for exercises that target the hamstrings"
84 
85## Configuration
86 
87| Option | Description |
88|--------|-------------|
89| `--api-key <key>` | API key (or set `MUSCLESWORKED_API_KEY` env var) |
90| `MUSCLESWORKED_API_URL` | Override base URL (default: `https://musclesworked.com`) |
91 
92## Development
93 
94```bash
95git clone https://github.com/csjoblom/musclesworked-mcp.git
96cd musclesworked-mcp
97npm install
98npm run build
99 
100# Test with MCP Inspector
101MUSCLESWORKED_API_KEY=mw_live_... npx @modelcontextprotocol/inspector node dist/index.js
102```
103 
104## License
105 
106MIT
107