Skip to main content
The client_ai_habits module lets a client’s AI assistant list assigned habits, review check-in history, and submit habit check-ins. Client AI tools are subject-bound: every call resolves to the authenticated client (subjectClientId) and can only touch habits assigned to that client. 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_list_my_habits

Retrieve all active habits assigned to your account, including their description, type, goal period, and log mode.
  • Type: Read-only
  • Important Input Fields: None.

​
client_ai_get_my_habit_entries

Retrieve a history of habit checks/entries for yourself within a specific date range (maximum 31 days). Optionally filter by habitId.
  • Type: Read-only
  • Important Input Fields:
    • dateFrom (string, required): Start date filter in ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ssZ).
    • dateTo (string, required): End date filter in ISO 8601 format. Max window is 31 days.
    • habitId (string, optional): Habit ID to filter entries.

​
client_ai_check_in_my_habit Write

Submit a completion check-in value or entry for a habit already assigned to yourself. Cannot create or edit habits.
  • Type: Write
  • Important Input Fields:
    • habitId (string, required): The unique ID of the habit (obtained from client_ai_list_my_habits).
    • occurredAt (string, required): ISO 8601 UTC date-time string when the habit was completed/checked.
    • value (number, required): The check-in value (e.g. 1 for a completed binary habit, or a numeric value).
    • note (string, optional): Notes accompanying the check-in. Max 500 chars.

​
Natural Language Examples

  • “Which habits do I need to complete today?”
  • “Check off my hydration habit — I drank 2 liters.”
  • “How consistent was I with my sleep habit over the last two weeks?”

​
JSON-RPC Call Example (client_ai_check_in_my_habit)