ClickTime MCP by usefulapi is an MCP server published by io.usefulapi, hosted at clicktime.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 26 tools, including clicktime_get_me, clicktime_get_company, clicktime_list_jobs, clicktime_get_job, clicktime_list_clients.
Read jobs, timesheets and reports; log time, update entries and submit timesheets in ClickTime.
4,125 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The ClickTime user this API token belongs to: id, name, email, security level (Standard, Manager, Admin), division, default task, approvers and timesheet preferences. The API token itself is never returned. GET /Me.
No parameters.
{
"name": "clicktime_get_me",
"title": "Get my user",
"description": "The ClickTime user this API token belongs to: id, name, email, security level (Standard, Manager, Admin), division, default task, approvers and timesheet preferences. The API token itself is never returned. GET /Me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get my user",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Company configuration: name, currency, week start, timesheet model, how the company names jobs/clients/tasks, restriction methods, and which optional modules are on (Expenses, TimeOffAccruals, SubJob phases). Call this first before using expense, time-off-request or phase tools. GET /Company.
No parameters.
{
"name": "clicktime_get_company",
"title": "Get company settings",
"description": "Company configuration: name, currency, week start, timesheet model, how the company names jobs/clients/tasks, restriction methods, and which optional modules are on (Expenses, TimeOffAccruals, SubJob phases). Call this first before using expense, time-off-request or phase tools. GET /Company.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get company settings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the jobs (projects) the token's user can log time to, by name, with job number, client, dates and active state. Use the ids to log time or filter entries. GET /Me/Jobs.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only jobs with exactly this name. |
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| my_jobs | boolean | true = only jobs assigned to the user (company job-list controls). |
| verbose | boolean | Also return the related Job/Client/Task/User objects and billable flags (slower, larger). |
| client_id | string | Only jobs of this client id (see clicktime_list_clients). |
| is_active | boolean | true = active jobs only, false = inactive only (default: both). |
| job_number | string | Only the job with this job number. |
{
"name": "clicktime_list_jobs",
"title": "List jobs (projects)",
"description": "List the jobs (projects) the token's user can log time to, by name, with job number, client, dates and active state. Use the ids to log time or filter entries. GET /Me/Jobs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only jobs with exactly this name."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"my_jobs": {
"type": "boolean",
"description": "true = only jobs assigned to the user (company job-list controls)."
},
"verbose": {
"type": "boolean",
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger)."
},
"client_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only jobs of this client id (see clicktime_list_clients)."
},
"is_active": {
"type": "boolean",
"description": "true = active jobs only, false = inactive only (default: both)."
},
"job_number": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only the job with this job number."
}
}
},
"annotations": {
"title": "List jobs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One job (project) by id: name, number, client, start/end dates, active state. GET /Me/Jobs/{jobID}.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | ClickTime job id. |
| verbose | boolean | Also return the related Job/Client/Task/User objects and billable flags (slower, larger). |
{
"name": "clicktime_get_job",
"title": "Get job",
"description": "One job (project) by id: name, number, client, start/end dates, active state. GET /Me/Jobs/{jobID}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "ClickTime job id."
},
"verbose": {
"type": "boolean",
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger)."
}
}
},
"annotations": {
"title": "Get job",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the clients the token's user can see, with client number, short name and active state. GET /Me/Clients.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only clients with exactly this name. |
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| is_active | boolean | true = active only, false = inactive only (default: both). |
| short_name | string | Only the client with this short name. |
| client_number | string | Only the client with this client number. |
{
"name": "clicktime_list_clients",
"title": "List clients",
"description": "List the clients the token's user can see, with client number, short name and active state. GET /Me/Clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only clients with exactly this name."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"is_active": {
"type": "boolean",
"description": "true = active only, false = inactive only (default: both)."
},
"short_name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only the client with this short name."
},
"client_number": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only the client with this client number."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the tasks (work categories) the token's user can log time against, with task code and active state. When the company restricts tasks per job, use clicktime_list_job_task_controls instead. GET /Me/Tasks.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only tasks with exactly this name. |
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| my_tasks | boolean | true = only tasks assigned to the user. |
| is_active | boolean | true = active only, false = inactive only (default: both). |
| task_code | string | Only the task with this task code. |
{
"name": "clicktime_list_tasks",
"title": "List tasks",
"description": "List the tasks (work categories) the token's user can log time against, with task code and active state. When the company restricts tasks per job, use clicktime_list_job_task_controls instead. GET /Me/Tasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only tasks with exactly this name."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"my_tasks": {
"type": "boolean",
"description": "true = only tasks assigned to the user."
},
"is_active": {
"type": "boolean",
"description": "true = active only, false = inactive only (default: both)."
},
"task_code": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only the task with this task code."
}
}
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The (job, task) combinations the user may log time on. Only valid when the company's TaskRestrictionMethod is 'byjob' (see clicktime_get_company); otherwise ClickTime answers 403. Active rows only unless filtered. GET /Me/Jobs/TaskControls.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-1000 (default 50). |
| job_id | string | Only pairs for this job id. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| task_id | string | Only pairs for this task id. |
{
"name": "clicktime_list_job_task_controls",
"title": "List valid job and task pairs",
"description": "The (job, task) combinations the user may log time on. Only valid when the company's TaskRestrictionMethod is 'byjob' (see clicktime_get_company); otherwise ClickTime answers 403. Active rows only unless filtered. GET /Me/Jobs/TaskControls.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only pairs for this job id."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"task_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only pairs for this task id."
}
}
},
"annotations": {
"title": "List valid job and task pairs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The phases (sub-jobs, level 1) defined on a job. Needs the company's SubJob/phases module (see clicktime_get_company). Use the phase id when logging time on a phased job. GET /Me/Jobs/{jobID}/JobPhase.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-1000 (default 50). |
| job_id * | string | ClickTime job id. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
{
"name": "clicktime_list_job_phases",
"title": "List job phases",
"description": "The phases (sub-jobs, level 1) defined on a job. Needs the company's SubJob/phases module (see clicktime_get_company). Use the phase id when logging time on a phased job. GET /Me/Jobs/{jobID}/JobPhase.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "ClickTime job id."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
}
}
},
"annotations": {
"title": "List job phases",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the token user's time entries, newest first: date, hours, job, task, comment, start/end time. Filter by one day (entry_date), a date range (start_date + end_date), job or task. Only days with logged time appear. Add verbose to get job/client names and the billable flag. GET /Me/TimeEntries.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 50). |
| job_id | string | Only entries on this job id. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| task_id | string | Only entries on this task id. |
| verbose | boolean | Also return the related Job/Client/Task/User objects and billable flags (slower, larger). |
| end_date | string | Last day of a date range, included (yyyy-mm-dd). |
| entry_date | array | Specific days (yyyy-mm-dd), up to 31. |
| start_date | string | First day of a date range (yyyy-mm-dd); use with end_date. |
One of the user's time entries by id, with hours, comment, date, job, task, phase and custom fields. GET /Me/TimeEntries/{timeEntryID}.
| Parameter | Type | Description |
|---|---|---|
| verbose | boolean | Also return the related Job/Client/Task/User objects and billable flags (slower, larger). |
| time_entry_id * | string | ClickTime time entry id. |
{
"name": "clicktime_get_time_entry",
"title": "Get time entry",
"description": "One of the user's time entries by id, with hours, comment, date, job, task, phase and custom fields. GET /Me/TimeEntries/{timeEntryID}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"time_entry_id"
],
"properties": {
"verbose": {
"type": "boolean",
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger)."
},
"time_entry_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "ClickTime time entry id."
}
}
},
"annotations": {
"title": "Get time entry",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the user's timesheets (pay periods), newest first, with period dates, status (Open, Waiting, Approved, Rejected, Locked...), total hours and who submitted or approved. GET /Me/Timesheets.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| status | array | Only timesheets in these states (Waiting = submitted and awaiting approval; submitted is the vendor's own alias). |
| to_date | string | Only timesheets starting on or before this date (yyyy-mm-dd). |
| from_date | string | Only timesheets ending on or after this date (yyyy-mm-dd). |
{
"name": "clicktime_list_timesheets",
"title": "List my timesheets",
"description": "List the user's timesheets (pay periods), newest first, with period dates, status (Open, Waiting, Approved, Rejected, Locked...), total hours and who submitted or approved. GET /Me/Timesheets.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"status": {
"type": "array",
"items": {
"enum": [
"Open",
"Waiting",
"Approved",
"Rejected",
"Locked",
"JobHold",
"TORAHold",
"submitted"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"description": "Only timesheets in these states (Waiting = submitted and awaiting approval; submitted is the vendor's own alias)."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only timesheets starting on or before this date (yyyy-mm-dd)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only timesheets ending on or after this date (yyyy-mm-dd)."
}
}
},
"annotations": {
"title": "List my timesheets",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The user's timesheet whose period contains a given day: period dates, status, day totals and the general actions (Submit, UndoSubmit...). GET /Me/Timesheets/{date}.
| Parameter | Type | Description |
|---|---|---|
| date * | string | Any day inside the timesheet period. |
{
"name": "clicktime_get_timesheet_by_date",
"title": "Get timesheet covering a date",
"description": "The user's timesheet whose period contains a given day: period dates, status, day totals and the general actions (Submit, UndoSubmit...). GET /Me/Timesheets/{date}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Any day inside the timesheet period."
}
}
},
"annotations": {
"title": "Get timesheet covering a date",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The status actions the user can take right now on the timesheet covering a date (Submit, UndoSubmit...). Check this before clicktime_submit_timesheet. GET /Me/Timesheets/{date}/Actions.
| Parameter | Type | Description |
|---|---|---|
| date * | string | Any day inside the timesheet period. |
{
"name": "clicktime_list_timesheet_actions",
"title": "List actions available on my timesheet",
"description": "The status actions the user can take right now on the timesheet covering a date (Submit, UndoSubmit...). Check this before clicktime_submit_timesheet. GET /Me/Timesheets/{date}/Actions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Any day inside the timesheet period."
}
}
},
"annotations": {
"title": "List actions available on my timesheet",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The time off types the user can take (vacation, sick...) with CurrentBalance, accrual and whether approval is required. Use for balance questions. GET /Me/TimeOffTypes.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| is_active | boolean | true = active types only (the only ones that can be booked). |
| requires_approval | boolean | Filter by approval-required types. |
{
"name": "clicktime_list_time_off_types",
"title": "List time off types and balances",
"description": "The time off types the user can take (vacation, sick...) with CurrentBalance, accrual and whether approval is required. Use for balance questions. GET /Me/TimeOffTypes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"is_active": {
"type": "boolean",
"description": "true = active types only (the only ones that can be booked)."
},
"requires_approval": {
"type": "boolean",
"description": "Filter by approval-required types."
}
}
},
"annotations": {
"title": "List time off types and balances",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Time off the user has taken or booked, newest first: date, hours, type, notes. Not requests or balances. GET /Me/TimeOff.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-500 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| to_date | string | Only entries on or before this date (yyyy-mm-dd). |
| from_date | string | Only entries on or after this date (yyyy-mm-dd). |
| time_off_type_id | string | Only this time off type id. |
{
"name": "clicktime_list_time_off",
"title": "List my time off",
"description": "Time off the user has taken or booked, newest first: date, hours, type, notes. Not requests or balances. GET /Me/TimeOff.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Results per page, 1-500 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only entries on or before this date (yyyy-mm-dd)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only entries on or after this date (yyyy-mm-dd)."
},
"time_off_type_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this time off type id."
}
}
},
"annotations": {
"title": "List my time off",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The user's time off requests with status and dates. Needs the company's TimeOffAccruals module (see clicktime_get_company). GET /Me/TimeOffRequests.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| status | array | Only requests in these statuses (Submitted = awaiting approval). |
| to_date | string | Only requests on or before this date (yyyy-mm-dd). |
| from_date | string | Only requests on or after this date (yyyy-mm-dd). |
{
"name": "clicktime_list_time_off_requests",
"title": "List my time off requests",
"description": "The user's time off requests with status and dates. Needs the company's TimeOffAccruals module (see clicktime_get_company). GET /Me/TimeOffRequests.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"status": {
"type": "array",
"items": {
"enum": [
"Submitted",
"Approved",
"Rejected",
"Cancelled"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"description": "Only requests in these statuses (Submitted = awaiting approval)."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only requests on or before this date (yyyy-mm-dd)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only requests on or after this date (yyyy-mm-dd)."
}
}
},
"annotations": {
"title": "List my time off requests",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The user's expense sheets with status, total and reimbursable amount, paid flag. Needs the company's Expenses module (see clicktime_get_company). GET /Me/ExpenseSheets.
| Parameter | Type | Description |
|---|---|---|
| paid | boolean | true = paid sheets only, false = unpaid only. |
| limit | integer | Results per page, 1-100 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| status | array | Only sheets in these statuses (waiting = submitted for approval). |
| to_date | string | Only sheets dated on or before this day (yyyy-mm-dd). |
| from_date | string | Only sheets dated on or after this day (yyyy-mm-dd). |
{
"name": "clicktime_list_expense_sheets",
"title": "List my expense sheets",
"description": "The user's expense sheets with status, total and reimbursable amount, paid flag. Needs the company's Expenses module (see clicktime_get_company). GET /Me/ExpenseSheets.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"paid": {
"type": "boolean",
"description": "true = paid sheets only, false = unpaid only."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"status": {
"type": "array",
"items": {
"enum": [
"open",
"waiting",
"approved",
"rejected",
"paid"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "Only sheets in these statuses (waiting = submitted for approval)."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only sheets dated on or before this day (yyyy-mm-dd)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only sheets dated on or after this day (yyyy-mm-dd)."
}
}
},
"annotations": {
"title": "List my expense sheets",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The user's expense items: date, type, amount, description, job, billable flag, sheet. Receipt images are not fetched. Needs the Expenses module. GET /Me/ExpenseItems.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-500 (default 50). |
| job_id | string | Only items charged to this job id. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| to_date | string | Only items dated on or before this day (yyyy-mm-dd). |
| from_date | string | Only items dated on or after this day (yyyy-mm-dd). |
| expense_sheet_id | string | Only items on this expense sheet id. |
{
"name": "clicktime_list_expense_items",
"title": "List my expense items",
"description": "The user's expense items: date, type, amount, description, job, billable flag, sheet. Receipt images are not fetched. Needs the Expenses module. GET /Me/ExpenseItems.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Results per page, 1-500 (default 50).",
"exclusiveMinimum": 0
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only items charged to this job id."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only items dated on or before this day (yyyy-mm-dd)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only items dated on or after this day (yyyy-mm-dd)."
},
"expense_sheet_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only items on this expense sheet id."
}
}
},
"annotations": {
"title": "List my expense items",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List people in the company with name, email, security level, division, approvers and active state. Needs a Manager or Admin token (others get 403). Cost and billing rates are included for Admins. GET /Users.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the user with exactly this name. |
| string | Only the user with this email. | |
| limit | integer | Results per page, 1-1000 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| is_active | boolean | true = active only, false = inactive only (default: both). |
| division_id | string | Only users in this division id. |
{
"name": "clicktime_list_users",
"title": "List users",
"description": "List people in the company with name, email, security level, division, approvers and active state. Needs a Manager or Admin token (others get 403). Cost and billing rates are included for Admins. GET /Users.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only the user with exactly this name."
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Only the user with this email."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Results per page, 1-1000 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"is_active": {
"type": "boolean",
"description": "true = active only, false = inactive only (default: both)."
},
"division_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only users in this division id."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Company-wide time entries (what the Time report shows): date, user, job, client, task, hours, billable flag, rates. Filter by date range, user, job, client, task, division or billable. Needs an Admin, or a Manager allowed to run company reports. Up to 2500 rows per page. GET /Reports/Time.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-2500 (default 50). |
| job_id | string | Only this job id. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| task_id | string | Only this task id. |
| user_id | string | Only this user id (see clicktime_list_users). |
| end_date | string | Last day, included (yyyy-mm-dd). |
| client_id | string | Only this client id. |
| start_date | string | First day (yyyy-mm-dd). |
| division_id | string | Only this division id. |
| is_billable | boolean | true = billable time only, false = non-billable only. |
Hours, billable hours, billings and cost totals grouped by Job, Task, User, Month, Date or WorkType (several groupings combine, for example Job + User). Needs a Manager or Admin token. ClickTime requires at least one of job_id, user_id or task_id as a filter. GET /Reports/TimeSummary.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-2500 (default 50). |
| job_id | string | Only this job id. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| task_id | string | Only this task id. |
| user_id | string | Only this user id. |
| end_date | string | Last day, included (yyyy-mm-dd). |
| group_by * | array | What to group the totals by: one of Job, Task, User, Month, Date, WorkType, or one of the pairs Task+User, Job+Task, Job+User, Job+Month. |
| start_date | string | First day (yyyy-mm-dd). |
| job_is_active | boolean | true = active jobs only. |
WRITE: log a time entry on the token user's own timesheet. Needs job_id and hours; task_id falls back to the user's default task; date defaults to today. Creates a NEW entry each call (not idempotent) and fails on a locked or submitted timesheet. Confirm date, hours, job, task and comment with the user first. POST /Me/TimeEntries.
| Parameter | Type | Description |
|---|---|---|
| date | string | Day worked, yyyy-mm-dd (default: today). |
| hours * | number | Hours worked, 0-24 (two decimals are kept). |
| job_id * | string | Job id (see clicktime_list_jobs). |
| comment | string | Comment, up to 2000 characters (some companies require one). |
| task_id | string | Task id; omitted = the user's default task. Under per-job task restrictions it must be valid for the job. |
| end_time | string | Time of day, HH:MM (24-hour). |
| phase_id | string | Phase id, on companies with phases. |
| break_time | number | Break hours. |
| start_time | string | Time of day, HH:MM (24-hour). |
| sub_phase_id |
WRITE: change one of the user's own time entries (hours, comment, job, task, start/end time, break). Only the fields you pass change; the date cannot be changed. Overwrites the previous values; a locked timesheet rejects it. Show the current and new values to the user first. PATCH /Me/TimeEntries/{timeEntryID}.
| Parameter | Type | Description |
|---|---|---|
| hours | number | Hours worked, 0-24 (two decimals are kept). |
| job_id | string | Move the entry to this job id. |
| comment | string | New comment (up to 2000 characters). |
| task_id | string | Move the entry to this task id. |
| end_time | string | Time of day, HH:MM (24-hour). |
| phase_id | string | Phase id. |
| break_time | number | Break hours. |
| start_time | string | Time of day, HH:MM (24-hour). |
| sub_phase_id | string | Sub-phase id. |
| time_entry_id * | string |
WRITE: submit the user's timesheet covering a date for approval (action Submit), or recall it (UndoSubmit). Submitting locks the entries and notifies the approver; confirm with the user first. Check the available actions with clicktime_list_timesheet_actions first. POST /Me/Timesheets/{date}/Actions.
| Parameter | Type | Description |
|---|---|---|
| date * | string | Any day inside the timesheet period. |
| action * | string | Submit = send for approval; UndoSubmit = recall a submitted timesheet. |
| comment | string | Optional comment for the approver (up to 2000 characters). |
| has_attestation | boolean | true when the company requires attesting the timesheet is accurate and the user agrees. |
{
"name": "clicktime_submit_timesheet",
"title": "Submit or recall my timesheet",
"description": "WRITE: submit the user's timesheet covering a date for approval (action Submit), or recall it (UndoSubmit). Submitting locks the entries and notifies the approver; confirm with the user first. Check the available actions with clicktime_list_timesheet_actions first. POST /Me/Timesheets/{date}/Actions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"date",
"action"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Any day inside the timesheet period."
},
"action": {
"enum": [
"Submit",
"UndoSubmit"
],
"type": "string",
"description": "Submit = send for approval; UndoSubmit = recall a submitted timesheet."
},
"comment": {
"type": "string",
"maxLength": 2000,
"description": "Optional comment for the approver (up to 2000 characters)."
},
"has_attestation": {
"type": "boolean",
"description": "true when the company requires attesting the timesheet is accurate and the user agrees."
}
}
},
"annotations": {
"title": "Submit or recall my timesheet",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: create a client. Needs an Admin, or a Manager allowed to add clients. Creates a NEW client each call (not idempotent); check clicktime_list_clients first to avoid duplicates. POST /Clients.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Client name (up to 50 characters). |
| notes | string | Notes. |
| is_active | boolean | Active (default true). |
| short_name * | string | Short name (required by ClickTime). |
| client_number | string | Client number (up to 50 characters). |
{
"name": "clicktime_create_client",
"title": "Create client",
"description": "WRITE: create a client. Needs an Admin, or a Manager allowed to add clients. Creates a NEW client each call (not idempotent); check clicktime_list_clients first to avoid duplicates. POST /Clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"short_name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Client name (up to 50 characters)."
},
"notes": {
"type": "string",
"maxLength": 2000,
"description": "Notes."
},
"is_active": {
"type": "boolean",
"description": "Active (default true)."
},
"short_name": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Short name (required by ClickTime)."
},
"client_number": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Client number (up to 50 characters)."
}
}
},
"annotations": {
"title": "Create client",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: create a job (project) under a client. Needs an Admin, or a Manager allowed to add jobs. Creates a NEW job each call (not idempotent); check clicktime_list_jobs first to avoid duplicates. POST /Jobs.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Job name (up to 50 characters). |
| notes | string | Notes. |
| end_date | string | End date (yyyy-mm-dd). |
| client_id * | string | Client id (see clicktime_list_clients). |
| is_active | boolean | Active (default true). |
| job_number * | string | Job number, unique within the company (up to 50 characters). |
| start_date | string | Start date (yyyy-mm-dd). |
| is_billable | boolean | Billable (only when the company sets billability per job). |
{
"name": "clicktime_create_job",
"title": "Create job",
"description": "WRITE: create a job (project) under a client. Needs an Admin, or a Manager allowed to add jobs. Creates a NEW job each call (not idempotent); check clicktime_list_jobs first to avoid duplicates. POST /Jobs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"job_number",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Job name (up to 50 characters)."
},
"notes": {
"type": "string",
"maxLength": 2000,
"description": "Notes."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "End date (yyyy-mm-dd)."
},
"client_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Client id (see clicktime_list_clients)."
},
"is_active": {
"type": "boolean",
"description": "Active (default true)."
},
"job_number": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Job number, unique within the company (up to 50 characters)."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Start date (yyyy-mm-dd)."
},
"is_billable": {
"type": "boolean",
"description": "Billable (only when the company sets billability per job)."
}
}
},
"annotations": {
"title": "Create job",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Tools for ClickTime, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many hours did I log last week, and on which jobs?"; "Log 2 hours on the Website Redesign job for today with the comment 'client call'."; "Which timesheets of mine are still open or rejected?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ClickTime data. Free plan: 50 tool calls per month. Run clicktime_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run clicktime_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run clicktime_upgrade without a plan: it returns both plans, each with a payment link for the user to open. clicktime_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "clicktime_list_time_entries",
"title": "List my time entries",
"description": "List the token user's time entries, newest first: date, hours, job, task, comment, start/end time. Filter by one day (entry_date), a date range (start_date + end_date), job or task. Only days with logged time appear. Add verbose to get job/client names and the billable flag. GET /Me/TimeEntries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only entries on this job id."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"task_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only entries on this task id."
},
"verbose": {
"type": "boolean",
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger)."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day of a date range, included (yyyy-mm-dd)."
},
"entry_date": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"maxItems": 31,
"minItems": 1,
"description": "Specific days (yyyy-mm-dd), up to 31."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day of a date range (yyyy-mm-dd); use with end_date."
}
}
},
"annotations": {
"title": "List my time entries",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "clicktime_time_report",
"title": "Time report (company-wide)",
"description": "Company-wide time entries (what the Time report shows): date, user, job, client, task, hours, billable flag, rates. Filter by date range, user, job, client, task, division or billable. Needs an Admin, or a Manager allowed to run company reports. Up to 2500 rows per page. GET /Reports/Time.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 2500,
"description": "Results per page, 1-2500 (default 50).",
"exclusiveMinimum": 0
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this job id."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"task_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this task id."
},
"user_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this user id (see clicktime_list_users)."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, included (yyyy-mm-dd)."
},
"client_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this client id."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day (yyyy-mm-dd)."
},
"division_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this division id."
},
"is_billable": {
"type": "boolean",
"description": "true = billable time only, false = non-billable only."
}
}
},
"annotations": {
"title": "Time report",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "clicktime_time_summary",
"title": "Time summary (grouped)",
"description": "Hours, billable hours, billings and cost totals grouped by Job, Task, User, Month, Date or WorkType (several groupings combine, for example Job + User). Needs a Manager or Admin token. ClickTime requires at least one of job_id, user_id or task_id as a filter. GET /Reports/TimeSummary.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"group_by"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 2500,
"description": "Results per page, 1-2500 (default 50).",
"exclusiveMinimum": 0
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this job id."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"task_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this task id."
},
"user_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Only this user id."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, included (yyyy-mm-dd)."
},
"group_by": {
"type": "array",
"items": {
"enum": [
"Job",
"Task",
"User",
"Month",
"Date",
"WorkType"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"description": "What to group the totals by: one of Job, Task, User, Month, Date, WorkType, or one of the pairs Task+User, Job+Task, Job+User, Job+Month."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day (yyyy-mm-dd)."
},
"job_is_active": {
"type": "boolean",
"description": "true = active jobs only."
}
}
},
"annotations": {
"title": "Time summary",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| string |
| Sub-phase id, on companies with two phase levels. |
| dcaa_explanation | string | Explanation required by DCAA-enabled companies when changing a past date. |
{
"name": "clicktime_create_time_entry",
"title": "Log time",
"description": "WRITE: log a time entry on the token user's own timesheet. Needs job_id and hours; task_id falls back to the user's default task; date defaults to today. Creates a NEW entry each call (not idempotent) and fails on a locked or submitted timesheet. Confirm date, hours, job, task and comment with the user first. POST /Me/TimeEntries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id",
"hours"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Day worked, yyyy-mm-dd (default: today)."
},
"hours": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Hours worked, 0-24 (two decimals are kept)."
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Job id (see clicktime_list_jobs)."
},
"comment": {
"type": "string",
"maxLength": 2000,
"description": "Comment, up to 2000 characters (some companies require one)."
},
"task_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Task id; omitted = the user's default task. Under per-job task restrictions it must be valid for the job."
},
"end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"phase_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Phase id, on companies with phases."
},
"break_time": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Break hours."
},
"start_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"sub_phase_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Sub-phase id, on companies with two phase levels."
},
"dcaa_explanation": {
"type": "string",
"maxLength": 2000,
"description": "Explanation required by DCAA-enabled companies when changing a past date."
}
}
},
"annotations": {
"title": "Log time",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| Time entry id (see clicktime_list_time_entries). |
| dcaa_explanation | string | Explanation required by DCAA-enabled companies when changing a past date. |
{
"name": "clicktime_update_time_entry",
"title": "Update time entry",
"description": "WRITE: change one of the user's own time entries (hours, comment, job, task, start/end time, break). Only the fields you pass change; the date cannot be changed. Overwrites the previous values; a locked timesheet rejects it. Show the current and new values to the user first. PATCH /Me/TimeEntries/{timeEntryID}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"time_entry_id"
],
"properties": {
"hours": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Hours worked, 0-24 (two decimals are kept)."
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Move the entry to this job id."
},
"comment": {
"type": "string",
"maxLength": 2000,
"description": "New comment (up to 2000 characters)."
},
"task_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Move the entry to this task id."
},
"end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"phase_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Phase id."
},
"break_time": {
"type": "number",
"maximum": 24,
"minimum": 0,
"description": "Break hours."
},
"start_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"sub_phase_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Sub-phase id."
},
"time_entry_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]+$",
"maxLength": 128,
"minLength": 1,
"description": "Time entry id (see clicktime_list_time_entries)."
},
"dcaa_explanation": {
"type": "string",
"maxLength": 2000,
"description": "Explanation required by DCAA-enabled companies when changing a past date."
}
}
},
"annotations": {
"title": "Update time entry",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}