Skip to main content
The client_ai_goals module lets a client’s AI assistant read and update the client’s own goals (weight targets, timeline, and daily targets). Client AI tools are subject-bound: every call resolves to the authenticated client (subjectClientId) and can never touch another client’s goals. The module is available only when the company MCP integration feature is enabled, client AI access is enabled for the client-company relationship, the company’s client MCP policy allows the module (write tools additionally require the company policy to allow them), and the client has granted health data consent.

​
Available Tools

​
client_ai_get_my_goals

Retrieve your own goals (weight target, timeline, nutrition macros target, active calories, steps, sleep, water, and measurement targets).
  • Type: Read-only
  • Important Input Fields: None.

​
client_ai_update_my_goals Write

Update safe stored goals (physicalActivity, weight targets, timeline, dailySteps, sleepDuration, waterIntake) for yourself. Arbitrary nested updates, assignments or coach metadata are rejected.
  • Type: Write
  • Important Input Fields:
    • fields (object, required): Goal fields to update. Only client-editable paths are accepted: goals.physicalActivity, weight.currentWeightKg, weight.targetWeightKg, timeline.startDate, timeline.endDate, dailyGoals.waterIntake, dailyGoals.dailySteps, and dailyGoals.sleepDuration. Any other field path is rejected.

​
Natural Language Examples

  • “What is my current weight goal?”
  • “Change my target weight to 78 kg.”
  • “Set my daily step goal to 10,000 and my water intake to 2.5 liters.”

​
JSON-RPC Call Example (client_ai_update_my_goals)