Skip to content

SparkyFitness

Productivity & Wikis

A self‑hosted, privacy‑first fitness tracker that lets users monitor nutrition, exercise, health metrics and more while keeping all data under their own control.

Track releases GitHub Website
TypeScript Latest v1.6.0 · 2d ago Security brief →

Features

  • Track nutrition, exercise, hydration, sleep, fasting, mood and body measurements
  • Set goals, daily check‑ins and view interactive charts & long‑term reports
  • Support multiple user profiles with family access and light/dark themes

Recent releases

View all 38 releases →
Review required
v1.6.0 Breaking risk
Auth

Unified versioning, workout redesign, FIT import

Open
Review required
v0.17.3 Breaking risk
Auth RBAC Breaking upgrade

AI coach, Liquid Glass, tracking, Fitbit deprecation

Open
Config change
v0.17.2 Breaking risk
Breaking upgrade Auth

MCP deprecation + Fitbit replacement

Open
v0.17.1 Breaking risk
⚠ Upgrade required
  • Backup before upgrading.
  • Refresh or clear browser cache if updates are not visible.
  • Use /mcp endpoint for external integrations (n8n, OpenClaw).
Breaking changes
  • Dedicated SparkyFitnessMCP container deprecated and scheduled for removal in an upcoming release; use /mcp endpoint instead.
  • Fitbit API support removed due to Google decommissioning; replaced with Google Health API.
Notable features
  • BMR label updated to dynamically display health source name
Full changelog

BREAKING CHANGE - MUST READ BELOW

⚠️ Backup before upgrading.
If you do not see the latest updates, please refresh the page or clear your browser cache.

⚠️ SparkyFitnessMCP dedicated container is deprecated.
ChatBot will automatically connect to MCP if the AI service is configured.
MCP is now served directly from the /mcp endpoint, for example: domain.com/mcp.
Use this endpoint for external tools such as n8n, OpenClaw, and similar integrations.
The dedicated SparkyFitnessMCP container is still available from the previous release, but it will be removed in the upcoming release.

⚠️ Fitbit API is being replaced.
As Google is decommissioning the Fitbit API, it is being replaced with the Google Health API.
Fitbit support will be removed once decommissioning is complete.

⚠️ Use caution with write-back functionality.
Write-back support for Apple Health and Google Health is part of an initial release.
This feature may require multiple iterations before it becomes fully stable.

⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade. Some funcationality like auto backup within SparkyFitness will not work if you don't upgrade.

https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is approximately $99 in remaining project expenses from mac mini, apple & google fees.

What's Changed

Features

  • feat: update BMR label to use dynamic health source name by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1611

Full Changelog: https://github.com/CodeWithCJ/SparkyFitness/compare/v0.17.0...v0.17.1

View release on GitHub
v0.17.0 Breaking risk
⚠ Upgrade required
  • MCP now served at /mcp endpoint; update external tools (e.g., n8n, OpenClaw) accordingly.
  • Plan Postgres upgrade in the upcoming months; auto‑backup may fail without it.
Breaking changes
  • SparkyFitnessMCP dedicated container is deprecated and will be removed in an upcoming release; use /mcp endpoint instead.
  • Fitbit API support will be removed once Google decommissions it, replaced by Google Health API.
Notable features
  • Google Health API integration
  • Mobile: edit ingredients of a logged meal and YAZIO provider integration (food search, barcode scan)
  • Health‑Connect write‑back for nutrition and hydration to Android Health Connect
Full changelog

BREAKING CHANGE - MUST READ BELOW

⚠️ Backup before upgrading.
If you do not see the latest updates, please refresh the page or clear your browser cache.

⚠️ SparkyFitnessMCP dedicated container is deprecated.
ChatBot will automatically connect to MCP if the AI service is configured.
MCP is now served directly from the /mcp endpoint, for example: domain.com/mcp.
Use this endpoint for external tools such as n8n, OpenClaw, and similar integrations.
The dedicated SparkyFitnessMCP container is still available from the previous release, but it will be removed in the upcoming release.

⚠️ Fitbit API is being replaced.
As Google is decommissioning the Fitbit API, it is being replaced with the Google Health API.
Fitbit support will be removed once decommissioning is complete.

⚠️ Use caution with write-back functionality.
Write-back support for Apple Health and Google Health is part of an initial release.
This feature may require multiple iterations before it becomes fully stable.

⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade. Some funcationality like auto backup within SparkyFitness will not work if you don't upgrade.

https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is approximately $99 in remaining project expenses from mac mini, apple & google fees.

What's Changed

Features

  • feat: add Google Health API integration by @ZeSlammy in https://github.com/CodeWithCJ/SparkyFitness/pull/1474
  • feat(mobile): edit ingredients of a logged meal by @jsandai in https://github.com/CodeWithCJ/SparkyFitness/pull/1482
  • feat(mobile): YAZIO provider integration - mobile food search, barcode scan and serving display by @thorethy1 in https://github.com/CodeWithCJ/SparkyFitness/pull/1480
  • Extend MCP tools for structured food, exercise, goals, and report data by @lev-ok in https://github.com/CodeWithCJ/SparkyFitness/pull/1485
  • Mobile Bug fixes + additions by @BryceKrispiess in https://github.com/CodeWithCJ/SparkyFitness/pull/1444
  • feat: Add Duplicate action to the food Actions menu by @jsandai in https://github.com/CodeWithCJ/SparkyFitness/pull/1511
  • Sync nutrition diary from Garmin Connect + by @gPinato in https://github.com/CodeWithCJ/SparkyFitness/pull/1506
  • feat: add outbound proxy support for HTTPS requests by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1520
  • feat: Add off-today date cues by @geracobo in https://github.com/CodeWithCJ/SparkyFitness/pull/1500
  • feat(health-connect): ingest Android Health Connect nutrition as food entries by @izadiegizabal in https://github.com/CodeWithCJ/SparkyFitness/pull/1503
  • Adaptive & Manual Goal mode implementation by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1519
  • added supported for USDA to import multiple unit type variants by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1538
  • feat(ai): add exponential backoff for Gemini quota errors (429) by @zeusal in https://github.com/CodeWithCJ/SparkyFitness/pull/1549
  • Added ability to copy from/copy to foods & meals from family member. by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1556
  • Removal of super user extensions in postgres by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1558
  • feat(web): add barcode manual entry and camera scanning to custom food form by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1562
  • Import BMR from mobile by @BryceKrispiess in https://github.com/CodeWithCJ/SparkyFitness/pull/1521
  • feat: add check-in progress photos (front, back, side) by @zeusal in https://github.com/CodeWithCJ/SparkyFitness/pull/1533
  • feat(health-connect): write nutrition & hydration back to Health Connect (Android) by @izadiegizabal in https://github.com/CodeWithCJ/SparkyFitness/pull/1529
  • swissfood implementation for mobile app by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1568
  • Formatted Whats New dialog and also added BREAKING CHANGE warning by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1573
  • github issue template update and pr transaltion automation from Spark… by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1578
  • feat: mobile date context improvements by @geracobo in https://github.com/CodeWithCJ/SparkyFitness/pull/1526
  • feat(mobile): copy a logged meal to another day by @jsandai in https://github.com/CodeWithCJ/SparkyFitness/pull/1574
  • feat: apple health nutrition sync and writeback by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1585
  • fix(mobile): send Origin header during login to satisfy better-auth CSRF checks by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1589
  • feature: Added Global Food & Exercise data provider. by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1590
  • Mobile Fast Tracking by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1598
  • Added ability to view, modify custom nutrients in the food form and food detail screens. by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1593
  • feat(writeback): remove SparkyFitness data from the OS health store (rollback) by @izadiegizabal in https://github.com/CodeWithCJ/SparkyFitness/pull/1599
  • added ability to hide/resize widgets on the diary page by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1604
  • feat: add exercise water loss to daily goal and activity report stats by @gPinato in https://github.com/CodeWithCJ/SparkyFitness/pull/1605
  • Add NixOS module by @dlip in https://github.com/CodeWithCJ/SparkyFitness/pull/1602
  • Add NixOS module by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1609

Fixes

  • fix(mobile): show active calories by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1499
  • Keep nutrition fields editable when Auto-Scale is on by @jsandai in https://github.com/CodeWithCJ/SparkyFitness/pull/1513
  • fix: DATE column timezone shift by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1518
  • fix(measurements): repair DELETE /measurements/check-in/{id} (500 on every delete) by @bamonroe in https://github.com/CodeWithCJ/SparkyFitness/pull/1530
  • fix(foods): close Edit Food dialog correctly when cancelling past enrties sync by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1534
  • fix: support user weight units in active workout playback and preset stats by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1535
  • Backup setting fixes for web by @BryceKrispiess in https://github.com/CodeWithCJ/SparkyFitness/pull/1537
  • Next/prev month buttons on android not showing in dark/Amoled by @BryceKrispiess in https://github.com/CodeWithCJ/SparkyFitness/pull/1528
  • Fix zero body measurements from Garmin overwriting valid historical data by @gPinato in https://github.com/CodeWithCJ/SparkyFitness/pull/1542
  • Check in error/bug fixes by @BryceKrispiess in https://github.com/CodeWithCJ/SparkyFitness/pull/1546
  • split child RLS policies and enforce ownership check on variant deletion by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1552
  • fix(server): resolve adaptive TDEE overestimation, tighten safety cap to ±500 kcal, and downgrade confidence for young trackers or logging gaps by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1555
  • Fix garmin nutrition sync data loss by @gPinato in https://github.com/CodeWithCJ/SparkyFitness/pull/1544
  • Use adjusted calorie goal for summary and per meal targets by @gPinato in https://github.com/CodeWithCJ/SparkyFitness/pull/1543
  • fix(tandoor): handle literal "null" string and malformed source_url in recipe mapping by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1559
  • fix(mobile): only show updated measurements on diary by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1567
  • fix for AI ChatBot using old 50 messages isntead of recent 50 messages. by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1570
  • fix for missing nutritional value while creating meal via ChatBot by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1577
  • fix(server): simplify meal retrieval by leveraging RLS for family library sharing by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1582
  • fix(auth): resolve OIDC group sync, provider endpoint mapping, and client token auth issues by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1583
  • fix: do not count both active calories and workouts by @apedley in https://github.com/CodeWithCJ/SparkyFitness/pull/1588
  • fix(garmin): resolving authentication usage by @dhruvinsh in https://github.com/CodeWithCJ/SparkyFitness/pull/1603

Documentation

  • external database doc update. by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1565

Other Changes

  • Subtract dietary fiber caloric contribution from calorie target before calculating macro targets by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1531
  • added pretieer for translation PR workflow by @CodeWithCJ in https://github.com/CodeWithCJ/SparkyFitness/pull/1580
  • chore(i18n): sync translations from Weblate by @github-actions[bot] in https://github.com/CodeWithCJ/SparkyFitness/pull/1581

New Contributors

  • @ZeSlammy made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1474
  • @lev-ok made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1485
  • @gPinato made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1506
  • @izadiegizabal made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1503
  • @bamonroe made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1530
  • @zeusal made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1549
  • @github-actions[bot] made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1581
  • @dhruvinsh made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1603
  • @dlip made their first contribution in https://github.com/CodeWithCJ/SparkyFitness/pull/1602

Full Changelog: https://github.com/CodeWithCJ/SparkyFitness/compare/v0.16.9...v0.17.0

View release on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
4,855
Forks
270
Languages
TypeScript PLpgSQL Python
View on GitHub Homepage Documentation

Install & Platforms

Install via
docker-compose binary
Mobile
Android IOS

Similar tools

workout-cool
SparkyBudget
recipes
wingfit
workout-tracker

Alternative to

MyFitnessPal

Beta — feedback welcome: [email protected]