> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Client AI Goals

> Reference for a connected client reading and updating their own goals.

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.

| Key                  | Value               |
| :------------------- | :------------------ |
| **Module Key**       | `client_ai_goals`   |
| **Sensitivity**      | `health`            |
| **Consent Required** | `healthDataConsent` |

***

## 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`)

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": "client-goals-1",
  "method": "tools/call",
  "params": {
    "name": "client_ai_update_my_goals",
    "arguments": {
      "fields": {
        "weight": {
          "targetWeightKg": 78
        },
        "dailyGoals": {
          "dailySteps": 10000
        }
      }
    }
  }
}
```
