> ## Documentation Index
> Fetch the complete documentation index at: https://clearthedocket.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Track time

> Use the MCP `track` tool to start, pause, resume, switch, stop, and inspect personal time.

Time tracking is available through the MCP `track` tool. It belongs to a person, not an agent
principal. Use `work:read` for `status` and `segments`; use `work:write` for time-changing actions.

## Timer actions

| Action | Result |
| - | - |
| `start` | Starts a timer for `taskId`, a new task named by `label`, or unnamed work. |
| `pause` | Pauses the running timer. |
| `resume` | Resumes it. |
| `switch` | Starts tracking different work. Pass `taskId` or `label`. |
| `stop` | Stops the timer. An unnamed session needs `label` before it can finish. |
| `status` | Returns the active timer and an optional personal suggestion. |
| `segments` | Lists recorded segments in an ISO-8601 `start` and `end` period. |

Starting the same task again within a minute continues its previous segment instead of recording a
break. A `status` suggestion comes from the person's own calendar and day plan. It is a suggestion,
not an instruction to start tracking.

```mermaid theme={"dark"}
stateDiagram-v2
  [*] --> Running: start or switch
  Running --> Paused: pause
  Paused --> Running: resume
  Running --> Finished: stop with named work
  Running --> Running: switch
  Finished --> [*]
```

## Examples

Start a timer for an existing task:

```json theme={"dark"}
{ "action": "start", "taskId": "01H..." }
```

Start an unnamed timer and name it when stopping:

```json theme={"dark"}
{ "action": "start" }
```

```json theme={"dark"}
{ "action": "stop", "label": "Investigate production alert" }
```

Use [Connect an AI agent](https://clearthedocket.com/docs/developers/connect-an-agent-mcp.md) to configure the MCP transport and
[MCP tools and resources](https://clearthedocket.com/docs/developers/mcp-tools-and-resources.md) for authority behavior.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.