Skip to main content
Glama
set-and-signal

set-and-signal

by aranlucas

Set & Signal 🏋️ · Make the next set obvious

CI License

Set & Signal is a self-hostable workout planner and training log, built as a React/Vite app embedded in a Go server. Hosted accounts use Convex for training records and SQLite for identity and operations; guest and standalone mobile training data stays on-device. An optional AI assistant and an OAuth-protected MCP endpoint let assistant clients work with training data.

Run locally

Use the Go version in go.mod, Node.js from .node-version, and pnpm from the root package.json. A Convex deployment is required to start the API.

pnpm install --frozen-lockfile

Complete Convex setup before starting the app. It creates web/.env.local and the local signing key:

pnpm dev

Open https://set-and-signal.localhost. The development command sources web/.env.local, stores API data in ./data, and runs both services through Portless. The first run may ask for sudo to bind port 443 and trust a local certificate. Vite proxies API, OAuth, discovery, and MCP requests to https://api.set-and-signal.localhost, keeping cookies and callbacks on the web origin. Passkeys registered for localhost do not carry over to this hostname.

For self-hosting, use .env.example for common runtime settings and internal/config/config.go for defaults. Set CONVEX_URL to the training deployment and keep PUBLIC_URL, ORIGIN, and the passkey RP_ID consistent with the public origin. See the Railway guide for the existing infrastructure and data-volume precautions.

A deployment operator controls the API, Convex project, and persistent volume. The optional OpenRouter feature sends selected prompts to that provider; review SECURITY.md before exposing an instance to other users.

Related MCP server: gym

Contributing and reference

Licensed under GNU AGPL v3 or later. Preserve the third-party attributions and exercise-media restrictions in NOTICE.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables agents to track workouts, body metrics, and training stats for registered users through a JSON-RPC MCP endpoint, with scoped agent permissions and a web dashboard.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables logging workouts, sets, routines, food, water, and macros through natural-language chat in any MCP client, with OAuth-based secure access and timezone-aware daily tracking.
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT and other MCP clients to securely read Health Connect-derived health and training history, retrieve daily readiness and workout briefs, save schema-validated coach reports, and trigger email delivery through OAuth-protected tools.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables conversational logging and retrieval of workouts, sets, weigh-ins, meals, goals, plans, and progress photos through MCP-capable AI clients, with authenticated per-user storage and export/query capabilities.
      ISC