MCP Server

https://workout.myoforge.app/mcp

Authorization: Bearer lftsk_your_key_here

{
  "mcpServers": {
    "myoforge": {
      "command": "npx",
      "args": ["mcp-remote", "https://workout.myoforge.app/mcp"]
    }
  }
}

{
  "mcpServers": {
    "myoforge": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://workout.myoforge.app/mcp",
        "--header",
        "Authorization: Bearer lftsk_your_key_here"
      ]
    }
  }
}

claude mcp add myoforge --transport http https://workout.myoforge.app/mcp

claude mcp add myoforge --transport http https://workout.myoforge.app/mcp \
  --header "Authorization: Bearer lftsk_your_key_here"

{
  "mcpServers": {
    "myoforge": {
      "httpUrl": "https://workout.myoforge.app/mcp",
      "authProviderType": "dynamic_discovery",
      "timeout": 30000
    }
  }
}

{
  "mcpServers": {
    "myoforge": {
      "httpUrl": "https://workout.myoforge.app/mcp",
      "headers": { "Authorization": "Bearer lftsk_your_key_here" },
      "timeout": 30000
    }
  }
}

https://workout.myoforge.app/mcp

{"maxWidth":1200,"url":"/doc","isLoggedIn":false}

{"doc":{"id":"mcp","title":"MCP Server","shortDescription":"Connect AI assistants like Claude or ChatGPT to MyoForge - create programs, log workouts, and analyze training through natural conversation.","order":2,"category":"Integrations","datePublished":"2026-03-07","dateModified":"2026-06-20"},"content":"## What is MCP?\n\nMCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools. MyoForge has an MCP server - so you can ask Claude, ChatGPT, or any MCP-compatible assistant to manage your programs and workout history through natural conversation.\n\nFor example, you could say \"Create a 4-day upper/lower program with linear progression\" and the AI will write the ForgeScript code, validate it, and save it to your account.\n\nRequires a premium subscription.\n\n## Connecting to MyoForge\n\nThe MyoForge MCP server URL is:\n\n```\nhttps://workout.myoforge.app/mcp\n```\n\nThere are two ways to authenticate:\n\n- **OAuth 2.1** (default) - On first use, your AI client opens a browser window to sign in with your MyoForge account, then handles token refresh automatically. Best for clients with a built-in connector UI (Claude.ai, ChatGPT).\n- **API key** - Pass a MyoForge API key (the same kind used for the [REST API](/docs/api)) as a Bearer token. No browser sign-in needed - handy for command-line clients or config-file setups. See [Using an API key](#using-an-api-key) below.\n\nBelow are setup instructions for each major AI platform.\n\n### Using an API key\n\nIf you'd rather not go through the OAuth browser flow, you can authenticate with an API key instead. This is the same key used by the REST API.\n\n1. Open MyoForge and go to **Settings**\n2. Tap **API Keys**\n3. Tap **Create API Key** and give it a name\n4. Copy the key - it starts with `lftsk_`\n\nThen send it in the `Authorization` header when configuring your MCP client:\n\n```\nAuthorization: Bearer lftsk_your_key_here\n```\n\nMost clients that let you set custom headers (Claude Code, config-file setups) support this. The per-client sections below show the API-key variant where applicable. Keep the key secret - if you lose it, delete it and create a new one.\n\n### Claude.ai (Web)\n\n1. Open [claude.ai](https://claude.ai)\n2. Go to **Settings** -> **Connectors**\n3. Click **Add custom connector** at the bottom\n4. Paste the URL: `https://workout.myoforge.app/mcp`\n5. Click **Add**\n6. You'll be redirected to sign in with your MyoForge account\n\nAfter that, MyoForge tools will be available in your conversations. You can also add it from the chat input - click the **Search and tools** menu, then **Add connectors**.\n\n### Claude Desktop\n\n#### Option A: Via Settings UI\n\n1. Open Claude Desktop\n2. Go to **Settings** -> **Connectors**\n3. Click **Add custom connector**\n4. Paste the URL: `https://workout.myoforge.app/mcp`\n5. Click **Add**\n6. You'll be redirected to sign in with your MyoForge account\n\n#### Option B: Via config file\n\nClaude Desktop doesn't support remote servers directly via `claude_desktop_config.json`. Use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) package as a bridge:\n\n1. Click the **Settings** icon (bottom-left corner)\n2. Go to the **Developer** tab\n3. Click **Edit Config** - this opens `claude_desktop_config.json`\n4. Add the MyoForge server:\n\n```json\n{\n \"mcpServers\": {\n \"myoforge\": {\n \"command\": \"npx\",\n \"args\": [\"mcp-remote\", \"https://workout.myoforge.app/mcp\"]\n }\n }\n}\n```\n\n5. Save the file and restart Claude Desktop\n6. On first use, Claude will open your browser to authenticate with MyoForge\n\nTo use an API key instead of the OAuth browser flow, pass it as a header via `mcp-remote`:\n\n```json\n{\n \"mcpServers\": {\n \"myoforge\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://workout.myoforge.app/mcp\",\n \"--header\",\n \"Authorization: Bearer lftsk_your_key_here\"\n ]\n }\n }\n}\n```\n\n### Claude Code\n\nRun this command in your terminal:\n\n```bash\nclaude mcp add myoforge --transport http https://workout.myoforge.app/mcp\n```\n\nThat's it. Claude Code will prompt for authentication on first use.\n\nTo authenticate with an API key instead of the OAuth browser flow, pass it as a header:\n\n```bash\nclaude mcp add myoforge --transport http https://workout.myoforge.app/mcp \\\n --header \"Authorization: Bearer lftsk_your_key_here\"\n```\n\n### ChatGPT\n\nChatGPT calls MCP connections \"Apps\" (previously \"Connectors\"). You'll need ChatGPT Plus, Pro, Team, Enterprise, or Edu.\n\n1. Open ChatGPT\n2. Go to **Settings** -> **Apps & Connectors**\n3. Scroll down and enable **Developer Mode** under Advanced settings\n4. Go to **Settings** -> **Connectors** -> **Create**\n5. Fill in:\n - **Name**: MyoForge\n - **Description**: Manage weightlifting programs and workout history\n - **Connector URL**: `https://workout.myoforge.app/mcp`\n6. Click **Create**\n7. ChatGPT will verify the connection and show available tools\n8. On first use, you'll be redirected to sign in with your MyoForge account\n\n### Gemini CLI\n\nGemini CLI supports remote MCP servers via `settings.json`.\n\n1. Open `~/.gemini/settings.json` (create it if it doesn't exist)\n2. Add the MyoForge server:\n\n```json\n{\n \"mcpServers\": {\n \"myoforge\": {\n \"httpUrl\": \"https://workout.myoforge.app/mcp\",\n \"authProviderType\": \"dynamic_discovery\",\n \"timeout\": 30000\n }\n }\n}\n```\n\n3. Start a Gemini CLI session\n4. Run `/mcp` to verify the server is connected\n5. On first use, run `/mcp auth myoforge` to authenticate with your MyoForge account\n\nTo use an API key instead, drop `authProviderType` and pass the key as a header:\n\n```json\n{\n \"mcpServers\": {\n \"myoforge\": {\n \"httpUrl\": \"https://workout.myoforge.app/mcp\",\n \"headers\": { \"Authorization\": \"Bearer lftsk_your_key_here\" },\n \"timeout\": 30000\n }\n }\n}\n```\n\n### Other MCP Clients\n\nAny MCP-compatible client that supports Streamable HTTP transport can connect. Point it at:\n\n```\nhttps://workout.myoforge.app/mcp\n```\n\nAuthenticate either via OAuth 2.1 (dynamic client registration is supported) or by sending an API key in the `Authorization: Bearer lftsk_...` header.\n\n## What Can You Do With It?\n\nOnce connected, you can ask the AI to:\n\n- **Create programs** - describe what you want and it'll write the ForgeScript\n- **Edit programs** - \"Add a fourth day focused on arms\" or \"Change squat progression to 5/3/1\"\n- **Review programs** - \"Is my program balanced? Am I hitting enough back volume?\"\n- **Log workouts** - \"I did 3x5 squats at 225lb and 3x8 bench at 155lb today\"\n- **Analyze history** - \"Show me my last 10 workouts\" or \"How has my squat progressed?\"\n- **Test progressions** - simulate workouts in the playground to verify the logic works\n- **Manage custom exercises** - create, update, or delete exercises not in the built-in list\n- **Configure gyms and equipment** - set up bars, plates, and fixed weights per gym\n- **Tune per-exercise settings** - set your 1RM, weight rounding, equipment, or notes for an exercise\n\nThe AI has access to the ForgeScript language reference and built-in program examples, so it can learn the syntax on the fly.\n\n## Available Tools\n\nThese are the tools the AI assistant can call on your behalf:\n\n### Programs\n\n| Tool | What it does |\n|------|-------------|\n| `list_programs` | List all your programs (id, name, active status) |\n| `get_program` | Get a program's full ForgeScript source. Use `id=current` for the active one |\n| `create_program` | Create a new program from ForgeScript code |\n| `update_program` | Update an existing program's source code |\n| `delete_program` | Delete a program (can't delete the active one) |\n\n### Workout History\n\n| Tool | What it does |\n|------|-------------|\n| `get_history` | List workout history records. Supports date filtering and pagination |\n| `get_history_record` | Get a single workout record by ID |\n| `create_history_record` | Log a new workout in ForgeScript Workouts format |\n| `update_history_record` | Update an existing workout record |\n| `delete_history_record` | Delete a workout record |\n\n### Custom Exercises\n\n| Tool | What it does |\n|------|-------------|\n| `list_custom_exercises` | List your custom exercises. Supports pagination via limit/cursor |\n| `get_custom_exercise` | Get a single custom exercise by ID |\n| `create_custom_exercise` | Create a custom exercise with name, target/synergist muscles, and types |\n| `update_custom_exercise` | Update an existing custom exercise. Only provided fields change |\n| `delete_custom_exercise` | Delete a custom exercise |\n\n### Gyms and Equipment\n\n| Tool | What it does |\n|------|-------------|\n| `list_gyms` | List your gyms (id, name, current flag, equipment count) |\n| `create_gym` | Create a new gym, copying the current gym's equipment |\n| `update_gym` | Rename a gym and/or make it the current one |\n| `delete_gym` | Delete a gym (can't delete the last one) |\n| `list_equipment` | List a gym's equipment, including soft-deleted ones |\n| `get_equipment` | Get a single equipment's full config (bar, plates, fixed weights, etc.) |\n| `update_equipment` | Update equipment config; set `isDeleted` to hide/restore it |\n| `create_custom_equipment` | Create a new custom equipment in a gym |\n\n### Exercise Settings\n\n| Tool | What it does |\n|------|-------------|\n| `list_exercise_data` | List per-exercise customizations (1RM, rounding, equipment overrides, notes, muscles, unilateral) |\n| `get_exercise_data` | Get the stored customizations for one exercise key (e.g. `squat_barbell`) |\n| `set_exercise_data` | Set/upsert per-exercise settings; pass `null` for a field to clear it |\n| `delete_exercise_data` | Clear all stored customizations for an exercise key |\n\n### Measurements\n\n| Tool | What it does |\n|------|-------------|\n| `list_measurements` | Overview of tracked body measurements (bodyweight, body parts, bodyfat): count + latest value per key |\n| `get_measurement` | Get the recorded history for one key (e.g. `weight`, `chest`, `bodyfat`), newest-first, paginated |\n| `add_measurement` | Record a new value with a unit suffix (e.g. `180lb`, `37cm`, `18%`); timestamp defaults to now |\n| `update_measurement` | Change the reading at a given timestamp (the timestamp itself is fixed — re-date via delete + add) |\n| `delete_measurement` | Delete a single recorded value |\n\n### Testing and Analysis\n\n| Tool | What it does |\n|------|-------------|\n| `run_playground` | Simulate a workout - complete sets, run progressions, verify logic works |\n| `get_program_stats` | Analyze a program: duration per day, weekly volume per muscle group, strength vs hypertrophy split |\n\n### Reference (No Auth Required)\n\nThese tools don't need authentication - the AI can call them anytime:\n\n| Tool | What it does |\n|------|-------------|\n| `get_forgescript_reference` | ForgeScript language reference - syntax, progressions, templates |\n| `get_forgescript_examples` | Complete program examples (5/3/1, GZCLP, PPL, etc.) |\n| `get_liftohistory_reference` | ForgeScript Workouts format reference for workout records |\n| `list_exercises` | All built-in exercise names and equipment variants |\n| `list_builtin_programs` | List of built-in programs available in the app |\n| `get_builtin_program` | Full source of a built-in program - great for learning ForgeScript |\n\n## Example Conversations\n\n**Creating a program:**\n> \"Create a 3-day full body program for a beginner. Linear progression, compound lifts only. Start with light weights.\"\n\nThe AI will read the ForgeScript reference, write the program, test it in the playground, and save it to your account.\n\n**Analyzing your training:**\n> \"Pull my last month of workouts and tell me if I'm progressing on squat.\"\n\nThe AI fetches your history, looks at the weights and reps over time, and gives you feedback.\n\n**Tweaking a program:**\n> \"My current program doesn't have enough back work. Add pull-ups and barbell rows.\"\n\nThe AI reads your current program, modifies the ForgeScript to add the exercises with appropriate progression, and saves the update.\n\n## Tips\n\n- The AI should read `get_forgescript_reference` before writing any program. If it doesn't, remind it.\n- Use `run_playground` to test before saving. Catches syntax errors and lets you verify progressions work.\n- `get_program_stats` is useful for checking program balance - volume per muscle group, session duration, etc.\n- Built-in programs (`list_builtin_programs` + `get_builtin_program`) are great examples for the AI to learn from.\n\n## REST API\n\nIf you want direct programmatic access instead of going through an AI assistant, MyoForge also has a [REST API](/docs/api) with the same capabilities. Generate an API key in Settings and make HTTP requests directly."}