Láidir MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
laidir-api
REST API and MCP server for Láidir, a local-first gym tracker.
TypeScript on AWS Lambda (arm64, nodejs24.x), deployed by GitHub Actions via OIDC.
Infrastructure lives in laidir-infra. This repo owns the Lambda code and the API contract.
Contract
Path | What |
Source of truth. OpenAPI 3.1 | |
Single-file bundle (generated). laidir-mobile generates its client from this | |
Versioned entity schemas (JSON Schema 2020-12), shared by REST and MCP | |
TypeScript types (generated) | |
Built-in exercise catalogue (static, versioned). See catalogue/ |
Entities: Profile, Exercise (custom), RoutineFolder, Routine, Workout (sets embedded). All carry id
(client UUID), type, schema_version, created_at, updated_at and deleted_at (soft delete). Weights are kilograms.
Built-in exercises are referenced as builtin:<slug>; slugs are permanent (deprecate, never delete).
Routines can sit in a RoutineFolder (folder_id); folders and routines are ordered by sort_order.
Deleting a folder tombstones it and removes folder_id from its routines. Readers treat a folder_id
that points to a missing or deleted folder as unfiled.
Changing the contract: edit openapi/ or schemas/, run pnpm gen, commit the generated files.
CI fails if they're stale. Breaking entity changes need a new schema_version and schemas/v2/.
Related MCP server: Health Coach MCP
Layout
src/api/ REST Lambda (laidir-<env>-api): GET /health, /v1/* (phase 3)
src/mcp/ MCP Lambda (laidir-<env>-mcp): /mcp, /.well-known/oauth-protected-resource (phase 4)
src/shared/ HTTP helpers (RFC 9457 problems), build info
scripts/ esbuild bundling
test/ Vitest: handlers + schema fixturesDevelopment
Node 24 and pnpm 12.
pnpm install
pnpm check # format, lint, spec lint, typecheck, test, build
pnpm gen # re-bundle the spec and regenerate types
pnpm build # dist/api/index.mjs, dist/mcp/index.mjsCI/CD
PR ─► checks: format · lint · spec lint · generated files fresh · typecheck · test · build
merge to main ─► deploy (GitHub Environment "prod", OIDC role laidir-gha-api-deploy-prod)
build → update-function-code (api, mcp) → wait → smoke test /health + /mcpThe deploy role can only update code on the two functions. Terraform owns their configuration.
The smoke test checks the
x-laidir-versionheader equals the merged commit, so it proves the new code is live.Actions are pinned to full commit SHAs; Dependabot keeps them and npm packages current, with a cooldown.
Rollback: revert the PR; the deploy runs again.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Wger MCP — wraps wger Workout Manager REST API (free, no auth for read)
Fitness MCP for coaches and gyms: build workouts and read clients' training from live Superset data.
Agent-first strength-training platform across iOS, Web & MCP: read & write workouts, PRs & plans.
Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks.
Related MCP Servers
- AlicenseAqualityDmaintenanceA stateless MCP server that exposes tools for evidence-based strength training, including classical powerlifting programs and fatigue management.826 PyPIMIT
- FlicenseNot gradedqualityCmaintenanceA personal health and fitness MCP server that provides tools for managing profile data, goals, body measurements, nutrition, workouts, sleep, check-ins, life events, analytics, and coach memories via Supabase Postgres.1-
- AlicenseNot gradedqualityDmaintenanceMCP server for Hevy that fetches live workout data and computes analytics like e1RM, PRs, volume, and consistency, while enabling writes for routines, folders, and body measurements without modifying workout history.46 npmMIT
- AlicenseNot gradedqualityCmaintenanceA remote MCP server that lets LLM clients read and change training data in a self-hosted openGym instance over HTTPS using the user's own openGym token. It covers routines, weekly scheduling, workout logging and editing, body weight and goals, plus custom exercises and plan imports, with conflict-safe conditional writes.AGPL 3.0