Habits

​

Available Tools

​

list_habit_templates

• Type: Read-only
• Important Input Fields: none
• Returns: templates[] with template configuration and reminder defaults.

​

create_habit_template

• Type: Write
• Required Write Grant: create_habit_template
• Important Input Fields:
  • name (string, required): Template name.
  • habitType (string, required): build or quit.
  • unit (string, required): Tracking unit.
  • goalValue (number/string, conditional): Required for build habits.
  • allowableValue (number/string, conditional): Required and non-negative for quit habits; zero is allowed.
  • goalPeriod (string, optional): day, week, month, or empty.
  • taskDaysMode (string, optional): everyday or specific.
  • specificDaysOfWeek[] (string[], conditional): Required for specific.
  • reminders[] (array, optional): Default reminders with enabled, time, and message.

​

update_habit_template

• Type: Write
• Required Write Grant: update_habit_template
• Important Input Fields:
  • templateId (string, required): Template ID from list_habit_templates.
  • Any writable template field from create_habit_template.

​

archive_habit_template

• Type: Write
• Required Write Grant: archive_habit_template
• Important Input Fields:
  • templateId (string, required): Template ID from list_habit_templates.

​

assign_habit_template_to_client

• Type: Write
• Required Write Grant: assign_habit_template_to_client
• Important Input Fields:
  • clientId (string, required): Client ID from search_clients.
  • templateIds[] (string[], required): One to 25 template IDs.
  • startDate (string, optional): Defaults to today in UTC.
  • endDate (string, optional): Optional end date on or after startDate.
  • duplicateStrategy (string, optional): skip by default, or fail.

​

list_client_habits

• Type: Read-only
• Important Input Fields:
  • clientId (string, required): Client ID from search_clients.

​

get_habit_entries

• Type: Read-only
• Important Input Fields:
  • clientId (string, required): Client ID from search_clients.
  • dateFrom (string, required): Start date or date-time.
  • dateTo (string, required): End date or date-time. Maximum range is 366 days.
  • habitId (string, optional): Habit ID from list_client_habits.

​

Natural Language Examples

• “List our standard habits and assign the hydration habit to client client_abc123.”
• “Create a standard habit for 8,000 steps per day.”
• “Is client client_abc123 keeping up with their hydration habit this month?”

​

JSON-RPC Call Example (assign_habit_template_to_client)

{
  "jsonrpc": "2.0",
  "id": "habit-template-1",
  "method": "tools/call",
  "params": {
    "name": "assign_habit_template_to_client",
    "arguments": {
      "clientId": "64b64c0f2f5f4c0012345678",
      "templateIds": ["64b64c0f2f5f4c00123456a1"],
      "startDate": "2026-08-27",
      "duplicateStrategy": "skip"
    }
  }
}