Log Time Entry
log_time_entryLogs time the connected person worked, from hours or minutes, against a project (by projectId, or by its code or name, e.g. "RISE"), a task or an activity code. Handles requests like "log 2 hours on RISE for the site survey". The entry is always the person's own, on the work date in their time zone (default today), rated and billable exactly as one typed in the app. Each requestKey logs at most one entry: a repeat call with the same requestKey (for example after a timeout) returns the entry the first call logged, marked replayed, instead of logging it twice. The result names the call that undoes it. Work on a company holiday or an approved leave day, or under a leave or holiday activity code, is not logged without confirmTimeOffDay: the result says which day off it is and nothing is written.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "log_time_entry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | No | Hours worked (e.g. 1.5). Give hours or minutes, not both; one of the two is required. | |
| taskId | No | Task ID to log against (optional). With no project, the entry goes on the task's project; with one, the task must be on that project. | |
| userId | No | Not needed when signed in: the entry is always the connected user's, and any other ID is refused. Applies only to a workspace connection with no signed-in user, naming whose time this is. | |
| minutes | No | Minutes worked (e.g. 90). Give hours or minutes, not both; one of the two is required. | |
| project | No | The project as the person said it: its code (e.g. "RISE") or its name. Matched exactly on code first. When several projects match, nothing is written and the candidates come back to ask about. Give projectId or project, not both. | |
| billable | No | Whether the time is billable (default true) | |
| entryDate | No | The work date as YYYY-MM-DD (e.g. "2026-03-29"). Defaults to today in the person's time zone. | |
| projectId | No | Project ID to associate with (optional) | |
| requestKey | No | A caller-chosen key unique to this one entry (8 to 128 letters, digits, dots, colons, underscores or hyphens). A repeat with the same key within a day returns the first entry instead of logging another. | |
| description | No | What was done | |
| activityCodeId | No | Activity code ID (optional), one of the workspace activity codes. Can set the rate. | |
| confirmTimeOffDay | No | True only when the person has said they really worked on a day that is a company holiday or approved leave for them, or wants the time under a leave or holiday activity. Without it, such an entry is not logged. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| undo | No | The call that reverses this one, with its arguments. | |
| entry | No | ||
| replayed | No | True when a call with this requestKey already logged the entry, so nothing new was logged | |
| timeOffConflict | No | Present when nothing was logged because the day is a day off or the activity is time off |