MCPTool reference
Time Entries
BlueSuite MCP tools for time entries
See connection and authentication and workflow rules before calling these tools.
Related REST API and behavior.
list_time_entries
List time entries with optional pagination and filters
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
page | integer | No | Page number (default: 1) |
per_page | integer | No | Results per page (default: 25) minimum: 1. maximum: 100. |
search | string | No | Search time entries |
sort_by | "id", "start_date", "end_date", "created_at", "modified_at" | No | Field to sort by. Unknown values fall back to the default sort. |
sort_direction | "asc", "desc" | No | Sort direction |
start_date | string | No | Filter: start date (YYYY-MM-DD) |
end_date | JSON value | No | Filter: end date (YYYY-MM-DD) |
user_id | string | No | Filter by user UUID. Use list_users to resolve names. Format: uuid. |
job_id | integer | No | Filter by job ID |
request_id | JSON value | No | Filter by request ID |
quote_id | JSON value | No | Filter by quote ID |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | array of object | Yes | The matching records for this page. |
pagination | object | No | How many more pages of results exist. Absent when the API returned an unpaged result. |
pagination.page | integer | When parent supplied | Current page number, 1-based. |
pagination.per_page | integer | When parent supplied | Number of results per page. |
pagination.total_pages | integer | When parent supplied | Total number of pages available. |
create_time_entry
Log time against a job, quote, request or service plan. Durations are in MINUTES, record two hours as 120, not 2. Defaults to the signed-in user; pass user_id to log time for a crew member.
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
start_date | string | Yes | Start date (YYYY-MM-DD) |
end_date | JSON value | Yes | End date (YYYY-MM-DD) |
start_time | string | No | Start time (HH:MM) |
end_time | JSON value | No | End time (HH:MM) |
total_time | integer | No | Duration in MINUTES, not hours, a two hour visit is 120. Max 1440 (one day). Either give this, or give start_time and end_time. |
description | string | No | Description of work done |
user_id | string | No | Whose time this is. Defaults to the signed-in user. Use list_users to resolve a name; the user must be a member of this workspace. Format: uuid. |
job_id | integer | No | Associated job ID |
request_id | JSON value | No | Associated request ID |
quote_id | JSON value | No | Associated quote ID |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
update_time_entry
Update an existing time entry
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Time entry ID |
start_date | string | No | Start date (YYYY-MM-DD) |
end_date | JSON value | No | End date (YYYY-MM-DD) |
start_time | string | No | Start time (HH:MM) |
end_time | JSON value | No | End time (HH:MM) |
total_time | integer | No | Duration in MINUTES, not hours, two hours is 120. Max 1440. |
description | string | No | Description of work done |
user_id | string | No | UUID of the user. Use list_users to resolve names. Format: uuid. |
job_id | JSON value or null | No | Associated job ID |
request_id | JSON value or null | No | Associated request ID |
quote_id | JSON value or null | No | Associated quote ID |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
delete_time_entry
Delete a time entry by ID
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Time entry ID |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
The downloadable tool schemas include the full input and output contracts. Tables describe schema-level required fields; cross-field rules still apply.