RyTask docs
MCP tools

time_report

Time report for a date range: planned-vs-interruption totals, weekly rows, and top items — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:read permission).

View as MarkdownOpen in ChatGPTOpen in Claude

Time report for a date range: planned-vs-interruption totals, weekly rows, and top items.

Required permissionwork:read
Capability IDtimeTracking.report
DestructiveNo

Parameters

ParameterTypeRequiredNotes
fromstringyes
tostringyes
projectIdstring (uuid)no
userIdstring (uuid)no

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
    },
    "to": {
      "type": "string",
      "pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
    },
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "userId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}

Access control

A call succeeds only when the personal access token's scopes and the holder's role both allow work:read (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.

On this page