sunderos-mcp

MCP server for Sunderos— a fitness tracking app with AI integration.

Connect your AI assistant to your Sunderos instance and manage workouts, programs, and exercises through natural language.

Setup

Add this to your .mcp.json (Claude Code, Gemini CLI, or any MCP client):

{
  "mcpServers": {
    "sunderos": {
      "command": "npx",
      "args": ["-y", "sunderos-mcp"],
      "env": {
        "SUNDEROS_API_URL": "https://your-instance.example.com",
        "SUNDEROS_API_KEY": "so_xxx"
      }
    }
  }
}

Getting an API Key

1. Log in to your Sunderos instance
2. Go to Settings > API Keys
3. Create a new key and copy the so_xxx value

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SUNDEROS_API_KEY | Yes | — | Your API key (so_xxx) | | SUNDEROS_API_URL | Yes | — | Base URL of your Sunderos instance |

What You Can Do

Talk to your AI naturally — the MCP tools handle the rest:

• "Show me my workout history for this week"
• "Create a 4-week upper/lower program"
• "What's my bench press PR?"
• "Log my body weight at 185 lbs"
• "Suggest weight adjustments based on my recent RPE"
• "Build me a push day template with 4 exercises"
• "How has my squat progressed over the last month?"

23 tools are available covering exercises, templates, programs, workout history, stats, body weight, and more.

Requirements

• Node.js 22+
• A running Sunderos instance with an API key