ows-mcp-server

MCP server for Open Workout System — connect Claude Desktop, Claude Code, or Cursor to OWS for AI-powered workout management.

Quick Start

1. Get an API token from your OWS account page
2. Add to your MCP client config:

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ows": {
      "command": "npx",
      "args": ["-y", "ows-mcp-server"],
      "env": {
        "OWS_API_TOKEN": "ows_your_token_here",
        "OWS_BASE_URL": "https://www.openworkoutsystem.com"
      }
    }
  }
}

Claude Code

Add to .claude/mcp.json in your project:

{
  "mcpServers": {
    "ows": {
      "command": "npx",
      "args": ["-y", "ows-mcp-server"],
      "env": {
        "OWS_API_TOKEN": "ows_your_token_here",
        "OWS_BASE_URL": "https://www.openworkoutsystem.com"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "ows": {
      "command": "npx",
      "args": ["-y", "ows-mcp-server"],
      "env": {
        "OWS_API_TOKEN": "ows_your_token_here",
        "OWS_BASE_URL": "https://www.openworkoutsystem.com"
      }
    }
  }
}

Available Tools

The MCP server exposes all OWS tools — query data, log workouts, manage exercises, track nutrition, and more. Run GET /api/remote/tools or see the API docs for the full list.

Resources

Three read-only resources are available:

| URI | Description | |-----|-------------| | ows://profile | User profile, fitness data, and settings | | ows://activity | 20 most recent activity log entries | | ows://notes | Saved user notes and preferences |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | OWS_API_TOKEN | Yes | Your OWS API token (starts with ows_) | | OWS_BASE_URL | No | API base URL (default: http://localhost:3000) |

Links

• API Documentation
• Open Workout System
• GitHub