GemFit.ai Docs

AI fitness logging with user-approved tools.

GemFit combines mobile fitness logging with a secure MCP server. Approved AI clients can use the MCP to read the authenticated user's profile, goals, day summaries, recent trends, and logs, then create editable review drafts for messy meals, workouts, body metrics, plans, updates, and deletes.

Remote MCP: https://gemfit.ai/api/gemfit/mcp
OAuth:      https://gemfit.ai/.well-known/oauth-protected-resource/api/gemfit/mcp
Docs:       https://gemfit.ai/mcp
Plain text: https://gemfit.ai/mcp.txt
Connect:    https://gemfit.ai/connect

claude mcp add --transport http gemfit https://gemfit.ai/api/gemfit/mcp

{
  "mcpServers": {
    "gemfit": {
      "url": "https://gemfit.ai/api/gemfit/mcp"
    }
  }
}

Logging flow

• User asks an AI client to log food or workouts.
• Client calls gemfit_get_profile_context and gemfit_get_day_summary.
• Client calls gemfit_get_data_quality_report before cleaning or repairing existing logs.
• Client calls draft tools such as gemfit_create_food_log_draft or gemfit_create_workout_log_draft.
• Same-day workouts should use workout log drafts, not future plan drafts.
• GemFit shows editable review cards.
• User approves in GemFit Connect, or explicitly approves a specific draft in chat when logs.confirm is granted.
• Stale cards can be rejected with gemfit_reject_pending_actions after explicit user rejection.
• Standard clients use OAuth. GemFit does not require users to paste personal API keys into local configs.

Security boundaries

GemFit MCP exposes user-owned fitness data only. It cannot access Systalog admin, billing admin, deployments, Supabase service role, schema changes, env vars, role changes, email systems, or other users.

What stays under the user's control

Connecting an assistant does not give it silent permission to rewrite a fitness history. Read scopes are separate from draft and confirmation scopes, and the connected user reviews the requested access before authorizing it. Food, workout, body-metric, plan, edit, and delete tools prepare structured actions that remain attributable to the authenticated account.

• Review cards show proposed values before a change is saved.
• Ambiguous meals and workouts can be corrected instead of being accepted as hidden guesses.
• Delete and repair actions use the same review boundary as new logs.
• Revoking the connection stops future MCP access without deleting the user's GemFit records.