Habits
Every Habits tool, with the scope it needs, its arguments and the API operation it calls.
10 tools
Archive habits
Destructiveatlas_habits_archive
Archive one habit by id. The API masks cross-user and cross-tenant habit ids.
- Scope
habits:write- Calls
- Example prompt
- Archive habit hab_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List habit at risk
Read onlyatlas_habits_at_risk_list
List habit-risk entries so an agent can identify streaks that need attention before they slip.
- Scope
habits:read- Calls
- Example prompt
- Which of my habits are at risk this week?
Arguments
This tool takes no arguments.
Notify habit at risk
Changes dataatlas_habits_at_risk_notify
Send at-risk habit notifications through the server-side notifier and return delivered/checked counts.
- Scope
habits:write- Calls
- Example prompt
- Send reminders for habits that are at risk.
Arguments
This tool takes no arguments.
Archive habits in bulk
Changes dataatlas_habits_bulk_archive
Archive 1-100 habits in one request for quarterly cleanup or stale habit maintenance.
- Scope
habits:write- Calls
- Example prompt
- Archive these stale habits: hab_1, hab_2, hab_3.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
ids | array of string | Yes |
Create habit check ins
Changes dataatlas_habits_check_ins_create
Record a habit check-in with an optional YYYY-MM-DD override and optional short note.
- Scope
habits:write- Calls
- Example prompt
- Check in habit hab_123 for today with a quick note.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
date | string | No | |
notes | string | No |
Delete habit check ins
Destructiveatlas_habits_check_ins_delete
Remove a habit check-in for one YYYY-MM-DD date without deleting the habit itself.
- Scope
habits:write- Calls
- Example prompt
- Remove my 2026-06-07 check-in from habit hab_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
date | string | Yes |
Create habits
Changes dataatlas_habits_create
Create a habit with a bounded name, optional emoji/notes, and optional target cadence.
- Scope
habits:write- Calls
- Example prompt
- Create a meditation habit for 5 days per week.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | |
emoji | string | No | |
notes | string | No | |
targetPerPeriod | integer | No | |
periodDays | integer | No |
Get habits
Read onlyatlas_habits_get
Read one habit by id with its streak and completion statistics. The API masks habits that belong to someone else.
- Scope
habits:read- Calls
- Example prompt
- How is my reading habit going?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List habits
Read onlyatlas_habits_list
List the caller's habits one page at a time, oldest first by default, with current streak, completion statistics, and risk inputs. Pass `nextCursor` back as `cursor` for the next page.
- Scope
habits:read- Calls
- Example prompt
- Show my current habits and streak health.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "createdAt" | "updatedAt" | "name" | No | The field to sort on: createdAt, updatedAt, name. createdAt by default. |
order | "asc" | "desc" | No | asc or desc. asc by default. |
Update habits
Changes dataatlas_habits_update
Patch one habit by id while preserving unspecified fields; at least one mutable field is required.
- Scope
habits:write- Calls
- Example prompt
- Rename habit hab_123 to Morning pages.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
name | string | No | |
emoji | string | null | No | |
notes | string | null | No | |
targetPerPeriod | integer | No | |
periodDays | integer | No |