AIm Workout Journal

A workout journal that Claude and ChatGPT write to. Tell your assistant what you trained and it saves the exercises, sets, reps and weights. Ask it for a program and it builds one from your goal, schedule and equipment, checked by AIm before it is kept. The journal opens in the browser on any phone, in English, Spanish, French, Portuguese or Russian. Live at aim-journal.com.

Add it to your assistant

• Claude: open AIm in the Claude directory and press Connect.
• ChatGPT: open AIm in the ChatGPT plugin directory and press Install plugin.
• Any other MCP client with OAuth: add https://aim-journal.com/mcp (streamable HTTP).

An AIm window asks for your email and a code it sends you. If you do not have a journal yet, AIm creates one there. Press Allow, then try: Make me a workout program in AIm for 3 days a week.

PT: diário de treino em que o Claude e o ChatGPT registram por você. Adicione pelo diretório do Claude ou do ChatGPT. ES: diario de entrenamiento en el que Claude y ChatGPT anotan por usted. Añádalo desde el directorio de Claude o de ChatGPT.

How it works

There are two ways in, on the same host, and both resolve to the same user_id:

https://<app>/mcp                OAuth 2.1 — add as a connector, approve in the browser
https://<app>/{token}            mobile web app / installable PWA
https://<app>/{token}/mcp        the original connector address, still supported
https://<app>/{token}/api/*      read only JSON the UI consumes

OAuth is what a connector uses now. The server is an OAuth 2.1 resource server: an unauthenticated call gets a 401 carrying RFC 9728 protected-resource metadata, the client discovers the authorization server from it, registers itself dynamically, and the user approves on a consent screen this app serves. Supabase Auth is the authorization server, so no authorization codes or access tokens are stored here; the access token's sub is mapped to an account through users.supabase_user_id. Nothing secret is pasted by hand.

The URL token predates it and still works, which is why every link already in someone's inbox kept working when OAuth landed. A token resolver middleware maps the leading path segment to a user and scopes every query by user_id; the OAuth path sets the same context variable from a verified token instead. Two doors, one scoping rule.

What the MCP server exposes

20 tools over stateless streamable HTTP (FastMCP):

• Logging: log_session, update_session, update_set, delete_session, import_document (paste an export from another tracker or a photo of a notebook page).
• Reading: get_sessions, get_session, get_stats (volume, progression, estimated 1RM via Epley), get_program, get_goals, get_body_metrics.
• Catalogue: search_exercise_pool (a curated global pool with illustrations), list_exercises, upsert_exercise.
• Coaching: get_coaching_context is the important one. It returns data only: this user's goal, experience, equipment, injuries (with the movement patterns that load them), recent working weights, goal-matched planning ranges and the intake state, for the task at hand (next workout, new program, weekly review), so the assistant plans from data rather than from nothing. How the assistant uses it lives in the server's MCP instructions. review_program_draft, update_coach_profile, upsert_goal, log_coach_event, log_body_metric keep that context current.

Repo layout

api/index.py      Vercel entrypoint (must stay at repo root, see below). Imports backend/src.
requirements.txt  Vercel's Python build reads this (must also stay at repo root).
backend/          Python package, tests, scripts, DB migrations.
web/              Vite + React SPA (own package.json, own dev server) and 

... [View full README on GitHub](https://github.com/persistmcp/aim#readme)