Skip to content
MCP tools
Updates dataHabitsMCP tool

habits_log

Mark a habit's progress for a day (the headline action — "mark my Bible reading done today").

Mark a habit's progress for a day (the headline action — "mark my Bible reading done today"). Upserts the per-day log: pass done=true to mark the day complete, plus optional checklist steps and tracker metrics. Defaults log_date to today. Idempotent — calling again for the same day updates that day's log. Returns the saved log row.

Parameters#

ParameterTypeRequiredDescription
habit_idstringYesUUID of the habit to log (required). Use habits_list to find. · Format: UUID
log_datestringNoThe day to log (YYYY-MM-DD). Defaults to today. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
donebooleanNoWhether the habit was completed for the day (default: true)
stepsobject (free-form)NoChecklist completion as { stepId: boolean } — keys match the habit's step_template ids.
metricsobject (free-form)NoTracker values as { trackerKey: value } — keys match the habit's tracker_schema keys.
notestringNoAn optional note for the day

Example prompts#

  • "Mark a habit's progress for a day (the headline action — "mark my Bible reading done today") — just ask in plain English."

Safety#

Updates data. Changes an existing record. The change is visible immediately in the app and can be edited back.