RyTask docs
MCP tools

log_time

Log time on a work item after the fact (duration or start/end; source=MCP) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).

View as MarkdownOpen in ChatGPTOpen in Claude

Log time on a work item after the fact (duration or start/end; source=MCP).

Required permissionwork:write
Capability IDtimeTracking.logTime
DestructiveNo

Parameters

ParameterTypeRequiredNotes
durationSecondsintegerno
startedAtstring (ISO date-time)no
endedAtstring (ISO date-time)no
datestringno
notestringno
billablebooleanno
classificationPLANNED | INTERRUPTIONno
workItemIdstring (uuid)yes

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "durationSeconds": {
      "type": "integer",
      "minimum": 0
    },
    "startedAt": {
      "type": "string",
      "format": "date-time"
    },
    "endedAt": {
      "type": "string",
      "format": "date-time"
    },
    "date": {
      "type": "string",
      "pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
    },
    "note": {
      "type": "string",
      "maxLength": 2000
    },
    "billable": {
      "type": "boolean"
    },
    "classification": {
      "type": "string",
      "enum": [
        "PLANNED",
        "INTERRUPTION"
      ]
    },
    "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.

On this page