MCPTool reference
Timesheets
BlueSuite MCP tools for timesheets
See connection and authentication and workflow rules before calling these tools.
Related REST API and behavior.
list_timesheets
List timesheets 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 timesheets |
sort_by | "id", "status", "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. |
status | "draft", "pending", "approved", "rejected" | No | Filter by status |
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. |
get_timesheet
Get a single timesheet by ID with expanded details
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Timesheet 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_timesheet_status
Update only the status of a timesheet. Use this for approval workflows (draft → pending → approved/rejected).
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Timesheet ID |
status | "draft", "pending", "approved", "rejected" | Yes | New status |
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.