Connect Your AI

Drive Open Workout System from the AI you already use — Claude, ChatGPT, or Claude Code. Your AI logs food and workouts, builds programs, and checks your progress through a secure connection you approve once and can revoke anytime.

How it works

OWS exposes a remote MCP (Model Context Protocol) server. When you add it to your AI client, the client sends you here to sign in and approve the connection (OAuth). The connection can read your data, log entries, and manage programs — it cannot touch admin features, bulk operations, or your progress photos. Manage or revoke connections from your Account page.

Connector URL:
https://YOUR-OWS-DOMAIN/api/mcp

Built-in chat vs. connectors

The AI chat inside OWS runs on the AI credit included with a subscription, or on your own provider key from the Account page. Connectors are different: your own Claude or ChatGPT does the thinking on your existing plan with that provider, and OWS only serves the tools — so connector use never draws on OWS AI credit.

Claude (claude.ai — web, iOS, Android)

Works on every plan, including Free (one connector). Connectors added on the web sync to the mobile apps — so Claude on your phone can log sets between exercises at the gym.

1. claude.ai → Settings → Connectors → "Add custom connector"
2. Paste the connector URL above
3. Click Connect — you'll be sent to OWS to sign in and approve
4. Ask Claude: "Log my weight: 180 lbs" or "What's my workout today?"

ChatGPT (developer mode)

1. ChatGPT → Settings → Apps & Connectors → Advanced → Developer mode
2. "Create" a connector with the URL above (OAuth)
3. Approve the connection when redirected to OWS
4. Enable the connector in a conversation and start asking

A listing in the ChatGPT Apps directory (no developer mode needed) is planned.

Claude Code / Desktop / Cursor (power users)

Two options: the HTTP connector with a personal API token (full tool set, ~58 tools), or the bundled stdio server — see the Remote Agent API docs. Generate a personal token on your Account page first.

# Claude Code — add the remote MCP server with your personal token
claude mcp add ows --transport http https://YOUR-OWS-DOMAIN/api/mcp \
  --header "Authorization: Bearer ows_your_token_here"

Hermes Agent (Nous Research)

Hermes connects over streamable HTTP with either auth style. OAuth gives the curated connector tool set with a one-time browser approval; a personal API token gives the full tool set. Add via CLI or ~/.hermes/config.yaml:

# One-time browser approval (OAuth — discovery, registration and
# token refresh are automatic):
hermes mcp add ows --url https://YOUR-OWS-DOMAIN/api/mcp --auth oauth
hermes mcp login ows

# Or with a personal API token (full tool set) in ~/.hermes/config.yaml:
mcp_servers:
  ows:
    url: "https://YOUR-OWS-DOMAIN/api/mcp"
    headers:
      Authorization: "Bearer ows_your_token_here"

Tools register as mcp_ows_<tool>. Hermes's scheduled automations pair well with OWS — e.g. a weekly job that reviews your training log and proposes next week's program adjustments.

What your AI can do

Read    profile, programs, goals, progress, exercise history, PRs
Log     food/macros, water, weight, completed sets
Find    exercises in the library, today's workout
Manage  training programs and goals

Privacy & control

Connections act only on your own account, every action is recorded in your activity log, and access tokens expire and rotate automatically. Disconnecting a client on the Account page revokes its access immediately. See the privacy policy.