wger-mcp

Juxsta/wger-mcp

3.2

If you are the rightful owner of wger-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The wger MCP Server is a production-ready Model Context Protocol server that integrates AI assistants with the wger fitness API for exercise discovery and workout management.

Tools
8
Resources
0
Prompts
0

wger MCP Server

License: MIT

A production-ready Model Context Protocol (MCP) server that provides AI assistants like Claude with seamless access to the wger fitness API. Search through 400+ exercises, create workout routines, and manage fitness data - all through natural conversation.

Overview

The wger MCP server enables AI assistants to integrate with wger, a free, open-source fitness and workout management platform. With this MCP server, Claude Desktop and other AI applications can:

  • Search and discover exercises by muscle group, equipment, or keywords
  • Retrieve detailed exercise information including form instructions
  • Create and manage workout routines for authenticated users
  • Add exercises to routines with customizable sets, reps, and weights

This server implements the Model Context Protocol, making it compatible with any MCP-enabled AI application.

Key Features

  • 8 Powerful Tools: Comprehensive exercise discovery and workout management capabilities
  • Type-Safe: Built with TypeScript in strict mode with full type definitions
  • Intelligent Caching: Automatic caching of static data to minimize API calls
  • Robust Authentication: JWT-based auth with automatic token refresh
  • Error Handling: User-friendly error messages with graceful fallbacks
  • High Test Coverage: 80%+ code coverage with unit and integration tests
  • Production Ready: Comprehensive logging, retry logic, and timeout handling
  • Zero Cost: Access to 400+ exercises from the free wger API

Quick Start

Prerequisites

  • Node.js 18.0.0 or higher
  • Claude Desktop (or another MCP-compatible application)
  • wger Account (optional, only needed for workout management features)

Installation

Option 1: Using Claude Code CLI (Recommended)

claude mcp add wger -e WGER_API_KEY=your_key_here -- npx -y @juxsta/wger-mcp

Option 2: Install globally via npm

npm install -g @juxsta/wger-mcp
claude mcp add wger -e WGER_API_KEY=your_key_here -- wger-mcp

Option 3: For development, clone and build locally

git clone https://github.com/Juxsta/wger-mcp.git
cd wger-mcp
npm install
npm run build

Basic Configuration

  1. Get your wger API credentials (optional for read-only features):

    • Visit wger.de and create an account
    • Generate an API key from your account settings
    • Or use your username and password

  2. Configure Claude Desktop:

    Open your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

    Add the wger MCP server:

    {
  "mcpServers": {
    "wger": {
      "command": "node",
      "args": ["/absolute/path/to/wger-mcp/dist/index.js"],
      "env": {
        "WGER_API_KEY": "your_api_key_here"
      }
    }
  }
}

  3. Restart Claude Desktop and start using the tools!

For detailed setup instructions, see .

Available Tools

Exercise Discovery

  • search_exercises - Search exercises with filters for muscle, equipment, category, and keywords
  • get_exercise_details - Get comprehensive information about a specific exercise
  • list_categories - List all exercise categories (strength, cardio, stretching, etc.)
  • list_muscles - List all muscle groups for filtering exercises
  • list_equipment - List all equipment types available

Workout Management (Authentication Required)

  • create_workout - Create a new workout routine
  • add_exercise_to_routine - Add exercises to a routine with sets, reps, and weights
  • get_user_routines - Retrieve all workout routines for the authenticated user

For complete tool documentation, see .

Example Usage

Once configured, simply chat with Claude:

You: "Find me some chest exercises I can do with dumbbells"

Claude: [Uses search_exercises tool with muscle=chest, equipment=dumbbells]
"I found several dumbbell chest exercises:
1. Dumbbell Bench Press
2. Dumbbell Flyes
3. Incline Dumbbell Press
..."

You: "Tell me more about the dumbbell bench press"

Claude: [Uses get_exercise_details tool]
"The dumbbell bench press is a compound exercise that targets..."

For more detailed examples and scenarios, see .

Authentication

The wger MCP server supports two authentication methods:

Option 1: API Key (Recommended)

export WGER_API_KEY="your_api_key_here"

Option 2: Username and Password

export WGER_USERNAME="your_username"
export WGER_PASSWORD="your_password"

Authentication is only required for workout management tools. Exercise discovery tools work without authentication.

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/Juxsta/wger-mcp.git
cd wger-mcp

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env

# Edit .env with your credentials

Build and Test

# Build the project
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Format code
npm run format

Project Structure

wger-mcp/
├── src/
│   ├── tools/          # MCP tool implementations
│   ├── client/         # HTTP client and auth
│   ├── schemas/        # Zod validation schemas
│   ├── types/          # TypeScript type definitions
│   ├── utils/          # Error handling and logging
│   ├── config.ts       # Configuration management
│   ├── server.ts       # MCP server setup
│   └── index.ts        # Entry point
├── tests/
│   ├── unit/           # Unit tests
│   ├── integration/    # Integration tests
│   └── fixtures/       # Test data
├── docs/               # Documentation
└── dist/               # Compiled JavaScript

API Reference

For complete API documentation including parameters, return values, and examples for all 8 tools, see the .

Contributing

We welcome contributions! Please see for:

  • How to set up your development environment
  • Code style guidelines
  • How to run tests
  • Pull request process
  • How to report bugs and request features

Resources

License

This project is licensed under the MIT License - see the file for details.

Support

Acknowledgments

Made with ❤️ for the AI and fitness communities