Starts or stops time tracking on a task. Pass action: "stop" to explicitly stop — it is a safe no-op (never starts a timer) if this task has no running timer. Pass action: "start" to explicitly start — it is a safe no-op if this task's timer is already running. Starting a timer always stops any other task's running timer for this user first (only one timer runs at a time); the response names that other task whenever this happens. Omit action for legacy toggle behavior: stops the timer if this task's timer is running, otherwise starts one (stopping any other running timer first). Use GetRunningTimerTool first if you need to know current timer state before deciding. Requires owner, admin, or member role.
Safety: Write
Tool names, field names, and schema descriptions remain in canonical MCP English so copied calls match the server exactly.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
task_id |
integer | no | The task ID. |
search |
string | no | Search by task name, description, or "#number". |
action |
string | no | Explicit action: "start" or "stop". Omit for legacy toggle behavior (stops if running on this task, otherwise starts). |
Example prompt
Use start-stop-timetrack-tool to help me with the relevant Taskavel task.
Example call
{
"name": "start-stop-timetrack-tool",
"arguments": {}
}