Habits
The habits endpoints of the FocusCrew API.
A * marks a required field. Path fields go in the address, query fields after a ?, body fields in JSON.
/api/v1/habitsYour habits
Every live habit with its goal, today’s progress, its streak and the last seven days.
| Field | In | Type | Meaning |
|---|---|---|---|
| timezone | query | IANA zone | Which calendar day "today" is. Your account’s zone when omitted. |
MCP tool: list_habits
/api/v1/habits/{id}/logLog a habit
Adds to a day (today unless you say which) — one unit, or an amount — or marks the period done.
| Field | In | Type | Meaning |
|---|---|---|---|
| id * | path | uuid | The id. |
| amount | body | integer | How much to add; 1 when omitted. Minutes for a timed habit. |
| done | body | boolean | true marks the whole period met instead of adding. |
| date | body | YYYY-MM-DD | Today when omitted. Never the future, never before the habit’s start. |
| timezone | body | IANA zone | Which day today is. Your account’s zone when omitted. |
{ "amount": 1 }MCP tool: log_habit