aid: sparkyfitness
name: SparkyFitness
description: >-
  SparkyFitness is a self-hosted, open-source health and fitness tracker for
  food, exercise, water, sleep, mood, body measurements and medications, built
  for families and designed around an AI assistant. It ships a full Express 5 +
  PostgreSQL REST API (423 operations across 328 paths, described by an
  OpenAPI 3.0 document the server generates and serves at /api/api-docs/json)
  and — unusually for a project this size — a first-party Model Context Protocol
  server running in-process at POST /mcp, exposing 56 tools for logging and
  reading a user's own health data under PostgreSQL row-level security. It
  synchronises with Garmin, Fitbit, Withings, Strava, Polar, Oura, Hevy, Apple
  HealthKit and Google Health Connect, and looks food up against OpenFoodFacts,
  USDA, FatSecret and Nutritionix. Because it is self-hosted, there is no vendor
  API host, no pricing and no signup: you run the containers and the API is
  yours. Distributed under a source-available non-commercial licence.
url: https://raw.githubusercontent.com/api-evangelist/sparkyfitness/refs/heads/main/apis.yml
x-type: company
x-source: harvest:health-device-stack
image: https://codewithcj.github.io/SparkyFitness/logo.png
specificationVersion: '0.20'
created: '2026-08-27'
modified: '2026-08-27'
tags:
- Company
- Health
- Fitness
- Nutrition
- Self-Hosted
- Open Source
- Wearables
- MCP
- AI Assistant
- Quantified Self
apis:
- name: SparkyFitness API
  description: >-
    The REST API served by the SparkyFitness server on your own deployment.
    423 operations across nine functional areas — nutrition and meals, fitness
    and workouts, wellness and metrics, goals and personalization, medications
    and GLP-1, external integrations, identity and security, AI and insights,
    and system administration. API-key authenticated, scoped by PostgreSQL row
    level security to the key's user.
  humanURL: https://codewithcj.github.io/SparkyFitness/developer/api-reference
  baseURL: https://{host}/api
  tags:
  - Health
  - Fitness
  - Nutrition
  - REST
  properties:
  - type: OpenAPI
    url: openapi/sparkyfitness-openapi.yml
  - type: Documentation
    url: https://codewithcj.github.io/SparkyFitness/developer/api-reference
  - type: Authentication
    url: authentication/sparkyfitness-authentication.yml
  - type: ErrorCatalog
    url: errors/sparkyfitness-problem-types.yml
  - type: Conventions
    url: conventions/sparkyfitness-conventions.yml
  - type: Idempotency
    url: conventions/sparkyfitness-conventions.yml
  - type: RateLimits
    url: rate-limits/sparkyfitness-rate-limits.yml
  - type: DataModel
    url: data-model/sparkyfitness-data-model.yml
  - type: Overlay
    url: overlays/sparkyfitness-openapi-overlay.yaml
- name: SparkyFitness MCP Server
  description: >-
    A first-party Model Context Protocol server running in-process inside the
    SparkyFitness API server, mounted at POST /mcp over a stateless streamable
    HTTP transport. 56 tools across food, exercise, check-ins, goals, coaching,
    vision, profile, reports and medications, authenticated with a Bearer API
    key and scoped to that key's user by row level security. Five admin-only
    developer tools bypass RLS and are off unless DEV_TOOLS_ENABLED=true.
  humanURL: https://codewithcj.github.io/SparkyFitness/features/mcp-server
  baseURL: https://{host}/mcp
  tags:
  - MCP
  - AI Assistant
  - Agents
  properties:
  - type: MCPServer
    url: mcp/sparkyfitness-mcp.yml
  - type: ToolCrosswalk
    url: mcp/sparkyfitness-tool-crosswalk.yml
  - type: Documentation
    url: https://codewithcj.github.io/SparkyFitness/features/mcp-server
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://codewithcj.github.io/SparkyFitness/
- type: Documentation
  url: https://codewithcj.github.io/SparkyFitness/
- type: DeveloperPortal
  url: https://codewithcj.github.io/SparkyFitness/developer/getting-started
- type: APIReference
  url: https://codewithcj.github.io/SparkyFitness/developer/api-reference
- type: GettingStarted
  url: https://codewithcj.github.io/SparkyFitness/install/docker-compose
- type: Support
  url: https://codewithcj.github.io/SparkyFitness/help-me
- type: HelpCenter
  url: https://discord.gg/vcnMT5cPEA
- type: GitHubOrganization
  url: https://github.com/CodeWithCJ
- type: SourceCode
  url: https://github.com/CodeWithCJ/SparkyFitness
- type: PrivacyPolicy
  url: https://codewithcj.github.io/SparkyFitness/privacy_policy
- type: License
  url: https://github.com/CodeWithCJ/SparkyFitness/blob/main/LICENSE
- type: FAQ
  url: https://codewithcj.github.io/SparkyFitness/faq
- type: ChangeLog
  url: https://github.com/CodeWithCJ/SparkyFitness/releases
- type: ChangeLog
  url: changelog/sparkyfitness-changelog.yml
- type: Packages
  url: packages/sparkyfitness-packages.yml
- type: Conformance
  url: conformance/sparkyfitness-conformance.yml
- type: Lifecycle
  url: lifecycle/sparkyfitness-lifecycle.yml
- type: Plans
  url: plans/sparkyfitness-plans-pricing.yml
- type: LLMsTxt
  url: llms/sparkyfitness-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: DomainSecurity
  url: security/sparkyfitness-domain-security.yml
x-enrichment:
  date: '2026-08-27'
  status: enriched
  artifacts_added: 23
  pass: local-v1