Focus
Every Focus tool, with the scope it needs, its arguments and the API operation it calls.
4 tools
List focus coaching suggestions
Read onlyatlas_focus_coaching_suggestions_list
List the calling user's current focus-coaching suggestions (0-3 short cards: habit at risk, stale goal, overcommitted day, break due, streak to celebrate). Cards are computed live from existing habits, goals, tasks, and focus sessions - nothing is persisted server-side. Each card has a stable `dismissibleKey` clients can suppress repeats with.
- Scope
profile:read- Calls
- Example prompt
- Give me today's focus coaching nudges.
Arguments
This tool takes no arguments.
Create focus sessions
Changes dataatlas_focus_sessions_create
Create a completed focus-session record for the calling user with phase, duration, timestamps, and optional task link.
- Scope
profile:write- Calls
- Example prompt
- Log a 25-minute focus session against task tsk_123 that started at 09:00Z.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
phase | "focus" | "short-break" | "long-break" | Yes | |
durationSec | integer | Yes | |
startedAt | string | Yes | |
endedAt | string | null | No | |
taskId | string | null | No |
Delete focus sessions
Destructiveatlas_focus_sessions_delete
Delete one caller-owned focus-session record by id. Cross-user and cross-tenant lookups stay masked by the API.
- Scope
profile:write- Calls
- Example prompt
- Delete focus session fs_123 from my history.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List focus sessions
Read onlyatlas_focus_sessions_list
List one page of the calling user's recent focus-session history, newest first, optionally bounded by an ISO datetime. Pass the nextCursor of a page as cursor to read the next one.
- Scope
profile:read- Calls
- Example prompt
- List my focus sessions since Monday.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
since | string | No | |
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 | "startedAt" | "createdAt" | "durationSec" | No | The field to sort on: startedAt, createdAt, durationSec. startedAt, newest first, by default. |
order | "asc" | "desc" | No | asc or desc. |