FAQ

FreeReps is a self-hosted server that stores and visualizes your health and training data from Apple Health, Oura, Withings, Hevy and Alpha Progression. It includes a web dashboard, a correlation explorer, and an MCP interface for AI assistants.

On your own server, in a PostgreSQL database with TimescaleDB. FreeReps never sends data to any third party.

A server (Linux or macOS) with Docker, an iPhone running the FreeReps app or Health Auto Export, and a Tailscale account. Tailscale provides encrypted access and identity-based authentication — it's how FreeReps handles auth.

Run docker compose up -d with the provided docker-compose.yml. See the GitHub README for full setup instructions.

No. Tailscale is required — FreeReps uses it for authentication and encrypted access. There is no built-in username/password login. You can disable Tailscale for local development (tailscale.enabled: false), but this removes all authentication and should never be used in production.

FreeReps supports 100+ HealthKit data types including heart rate, blood pressure, blood glucose, sleep, workouts with GPS routes, ECG recordings, audiograms, medications, and more.

Yes. In addition to HealthKit workouts, FreeReps syncs Hevy and imports Alpha Progression CSV exports — exercises, sets, reps, weight and effort ratings. From those it derives volume per muscle group, tonnage and estimated 1RM.

Oura, Withings and Hevy are integrated today, alongside Apple Health, and Alpha Progression CSV exports can be imported. If you'd like to see a specific integration, please open an issue on GitHub.

Model Context Protocol (MCP) lets AI assistants like Claude query your health data directly. FreeReps exposes your data as MCP tools and resources over stdio and over Streamable HTTP at /mcp.

Yes. FreeReps is open source under the MIT license. Contributions are welcome on GitHub.

Please open an issue on GitHub.