Time tracking
Every Time tracking tool, with the scope it needs, its arguments and the API operation it calls.
14 tools
Get time approvals
Read onlyatlas_time_approvals_get
Fetch one time-entry approval request by id for reviewer inspection before deciding it.
- Scope
time:read- Calls
- Example prompt
- Open time approval tap_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List time approvals
Read onlyatlas_time_approvals_list
List time-entry approval requests for reviewers, optionally filtered by approval status.
- Scope
time:read- Calls
- Example prompt
- List pending time approvals.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
status | "PENDING" | "APPROVED" | "REJECTED" | No |
Review time approvals
Changes dataatlas_time_approvals_review
Approve or reject one pending time-entry approval request with an optional bounded reviewer note. Idempotent per MCP invocation.
- Scope
time:write- Calls
- Example prompt
- Approve time approval tap_123 with a note.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
approve | boolean | Yes | |
note | string | No |
Create time entries
Changes dataatlas_time_entries_create
Create a completed manual time entry with ISO start and end instants plus optional task, project, billable flag, and description. Idempotent per MCP invocation.
- Scope
time:write- Calls
- POST /time-entries
- Example prompt
- Log 90 minutes yesterday for project prj_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | No | |
projectId | string | No | |
description | string | No | |
billable | boolean | No | |
startsAt | string (date-time) | Yes | |
endsAt | string (date-time) | Yes |
Get time entries daily totals
Read onlyatlas_time_entries_daily_totals_get
Compute daily total and billable seconds for caller-visible time entries across an optional ISO date window, task, or project.
- Scope
time:read- Calls
- Example prompt
- Show daily billable totals for this week.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
from | string (date-time) | No | Inclusive lower bound as an ISO 8601 instant. |
to | string (date-time) | No | Exclusive upper bound as an ISO 8601 instant. |
taskId | string | No | |
projectId | string | No |
Delete time entries
Destructiveatlas_time_entries_delete
Delete one caller-visible time entry by id. Use only after confirming the row should be removed. Idempotent per MCP invocation.
- Scope
time:delete- Calls
- DELETE /time-entries/{x}
- Example prompt
- Delete duplicate time entry ten_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Export time entries
Read onlyatlas_time_entries_export
Export caller-visible time entries as CSV for an optional ISO date window, task, or project. Returns the CSV text with its content type. Requires the dedicated time-tracking export permission.
- Scope
time:read- Calls
- Example prompt
- Export this month of project prj_123 time entries as CSV.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
from | string (date-time) | No | Inclusive lower bound as an ISO 8601 instant. |
to | string (date-time) | No | Exclusive upper bound as an ISO 8601 instant. |
taskId | string | No | |
projectId | string | No |
List time entries
Read onlyatlas_time_entries_list
List one page of caller-visible time entries for an optional ISO date window, task, or project, newest first. Pass the nextCursor of a page as cursor to read the next one. Use this before summarizing billable work or auditing a timesheet.
- Scope
time:read- Calls
- GET /time-entries
- Example prompt
- List my billable time entries for this week.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
from | string (date-time) | No | Inclusive lower bound as an ISO 8601 instant. |
to | string (date-time) | No | Exclusive upper bound as an ISO 8601 instant. |
taskId | string | No | |
projectId | 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 | "startsAt" | "createdAt" | "updatedAt" | No | The field to sort on: startsAt, createdAt, updatedAt. startsAt, newest first, by default. |
order | "asc" | "desc" | No | asc or desc. |
Get time entries project totals
Read onlyatlas_time_entries_project_totals_get
Compute per-project total seconds and entry counts for caller-visible time entries across an optional ISO date window, task, or project.
- Scope
time:read- Calls
- Example prompt
- Summarize time by project for last month.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
from | string (date-time) | No | Inclusive lower bound as an ISO 8601 instant. |
to | string (date-time) | No | Exclusive upper bound as an ISO 8601 instant. |
taskId | string | No | |
projectId | string | No |
Get time entries running
Read onlyatlas_time_entries_running_get
Return the currently running time entry for the caller, or null when no timer is active.
- Scope
time:read- Calls
- GET /time-entries/running
- Example prompt
- Do I have a timer running right now?
Arguments
This tool takes no arguments.
Start time entries
Changes dataatlas_time_entries_start
Start a caller time-entry timer with optional task, project, billable flag, description, and ISO start override. Idempotent per MCP invocation.
- Scope
time:write- Calls
- POST /time-entries/start
- Example prompt
- Start a billable timer on task tsk_123 for project prj_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | No | |
projectId | string | No | |
description | string | No | |
billable | boolean | No | |
startsAt | string (date-time) | No | Optional timer start override as an ISO 8601 instant. |
Stop time entries
Changes dataatlas_time_entries_stop
Stop one running time entry by id and return the completed row. Idempotent per MCP invocation.
- Scope
time:write- Calls
- POST /time-entries/{x}/stop
- Example prompt
- Stop time entry ten_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Submit time entries
Changes dataatlas_time_entries_submit
Submit one caller-visible time entry for manager approval. Use after confirming the entry is complete and ready for review. Idempotent per MCP invocation.
- Scope
time:write- Calls
- Example prompt
- Request approval for time entry ten_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Update time entries
Changes dataatlas_time_entries_update
Patch one time entry by id, allowing task/project/description clearing with null and strict ISO time corrections. Idempotent per MCP invocation.
- Scope
time:write- Calls
- PATCH /time-entries/{x}
- Example prompt
- Mark time entry ten_123 as billable and correct the description.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
taskId | string | null | No | |
projectId | string | null | No | |
description | string | null | No | |
billable | boolean | No | |
startsAt | string (date-time) | No | |
endsAt | string (date-time) | No |