trenuj.se

An MCP-first training plan manager with Strava integration — plan and coach your training through an AI agent, track it in a React web app.
Explore the docs »

View Demo · Report Bug · Request Feature

trenuj.se is an MCP-first training plan manager. Instead of clicking through forms, you talk to an AI agent — it builds your plan, schedules workouts into phases, writes coaching notes, and reconciles what you planned against what you actually did via Strava. A React web app renders the plan, tracks progress, and lets you share plans publicly.

The whole thing runs on a single Cloudflare Worker: a Hono API and a Model Context Protocol server on the backend, a React 19 SPA served as static assets on the frontend, and Supabase (PostgreSQL + auth) for data and identity.

(back to top)

• MCP-first — a full MCP server (30+ tools) lets any MCP-capable AI client manage plans, phases, workouts, notes, and analytics.
• Strava integration — OAuth connect, webhook-driven activity sync, and auto-matching of activities to planned workouts by date + sport.
• Training analytics — week summaries, plan progress, and planned-vs-actual comparisons, with Recharts-backed charts in the web app.
• Public plan sharing — generate share links with per-field visibility flags.
• Per-plan agent memory — a freeform notepad the agent reads and edits to carry context between sessions.
• Secure by default — Supabase Row Level Security on every table, OAuth 2.1 for the MCP endpoint, and time-limited tokens for Strava stream access.

(back to top)

(back to top)

To get a local copy up and running, follow these steps.

• Node.js (ES2023 target) and pnpm — always use pnpm, never npm or npx.

  npm install -g pnpm

• A Supabase project (provides PostgreSQL + auth).
• A Strava API app (for the OAuth integration).

1. Clone the repo

   git clone https://github.com/bibixx/trenuj-se.git
   cd trenuj-se

2. Install dependencies

   pnpm install

3. Create your local env file and fill in the values (see Environment Variables)

   cp .dev.vars.example .dev.vars

4. Run the database migrations (requires DATABASE_URL)

   pnpm db:migrate

5. Start developing

   pnpm dev          # Vite dev server (frontend, HMR)
   pnpm dev:server   # Wrangler — the Workers runtime (API + MCP), in a second terminal
   # or run a single prod-like server that serves the built assets:
   pnpm cf:dev       # build, then wrangler dev

Copy .dev.vars.example to .dev.vars and fill in the following.

(back to top)

Open the web app at www.trenuj.se to view plans, track workouts, and manage your Strava connection. The plan itself is created and maintained by an AI agent over MCP.

The MCP server is exposed at {SERVER_URL}/mcp (e.g. https://www.trenuj.se/mcp) over Streamable HTTP, authenticated with OAuth 2.1. For example, with the Claude Code CLI:

claude mcp add trenuj-se \
  --transport streamable-http \
  "https://www.trenuj.se/mcp"

On first connection you'll be prompted to log in and approve access. See MCP.md for full per-client setup (Claude Desktop, Claude Code, Cursor, VS Code / Copilot), the OAuth-fallback token flow, and usage guidance.

The server registers 30+ tools across six categories. Full parameter docs live in MCP.md.

The server also exposes a training-plan-guide resource (guide://training-plan-guide) with conventions for workout descriptions, metadata shapes, colors, icons, and chart blocks — read it before creating or modifying plans.

Planned workouts can show up in the watch's native Workout app via Workout Feed — a generic iOS companion app that consumes .workout feeds. trenuj.se is one producer of that feed: it serves the manifest at /api/watch/index.json and individual workouts at /api/watch/w/<id>.workout (Apple WorkoutKit binaries built with @bibixx/workoutkit), authenticated by a long-lived watch token (Authorization: Bearer … header, or ?token= for clients that can't set headers). Tokens are stored hashed in the watch_tokens table and are individually revocable from the settings page.

To connect the two:

1. Enable the companion_app flag on your profile (the user_flags JSONB column in the database).
2. In the web app go to Settings → Apple Watch → Create token, name the token, then copy the shown Root URL and Authorization values (the Authorization value is shown only once).
3. Build and install Workout Feed on your iPhone (its README covers the two-command setup) and paste both values into the app.

From then on the app keeps the watch stocked automatically. For local development, point it at http://<your-mac-ip>:8787/api/watch/index.json — the app allows plain http on the LAN.

For architecture, conventions, and contributor guidance, see AGENTS.md.

(back to top)

• Enable Strava webhook signature verification once Strava surfaces STRAVA_WEBHOOK_SIGNING_SECRET.
• Retire the Claude OAuth-fallback token flow once upstream OAuth bootstrap is reliable.
• Add a product screenshot to the README.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Please make sure pnpm lint, pnpm format:check, and pnpm test pass before opening a PR.

(back to top)

No license has been specified yet, so default copyright applies (all rights reserved). If you intend to open-source this, add a LICENSE file and update this section.

(back to top)

Bartek Legięć — @bibixx

Project Link: https://github.com/bibixx/trenuj-se

(back to top)

• Best-README-Template
• Model Context Protocol
• Strava API
• Supabase
• Cloudflare Workers & Hono
• Drizzle ORM
• TanStack
• Tabler Icons
• Img Shields

(back to top)