start_timer
Start a timer on a work item (one active per user; server-persisted) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
Start a timer on a work item (one active per user; server-persisted).
| Required permission | work:write |
| Capability ID | timeTracking.startTimer |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
note | string | no | |
workItemId | string (uuid) | yes |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"note": {
"type": "string",
"maxLength": 2000
},
"workItemId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workItemId"
],
"additionalProperties": false
}Access control
A call succeeds only when the personal access token's scopes and the holder's role both allow work:write (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.
set_member_role
Change a member's role (Admin+; last-owner protected) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the members:write permission).
stop_timer
Stop the caller’s running timer and write a finalized time log (source=MCP) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).