> ## Documentation Index
> Fetch the complete documentation index at: https://ekso.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Time

> MCP tools for managing time entries and resource time logs.

## get\_time\_entries

Get non-billable time entries for a user within a date range.

| Property      |     |
| ------------- | --- |
| **Read-only** | Yes |

### Parameters

| Parameter  | Type     | Required | Default    | Description                                                    |
| ---------- | -------- | -------- | ---------- | -------------------------------------------------------------- |
| `userId`   | string   | Yes      | —          | User ID. Use [`get_user_list`](/mcp-tools/user#get_user_list). |
| `fromDate` | DateTime | No       | 7 days ago | Start of date range.                                           |
| `toDate`   | DateTime | No       | Today      | End of date range.                                             |

### Returns

A list of `TimeEntryDto` objects, each containing:

* `timeEntryId` — unique time entry identifier
* `userId` — the user who logged the time
* `nonBillableId` — non-billable category ID
* `timeLogged` — duration string (e.g. `2h 30m`)
* `comment` — optional comment
* `dated` — the date the time was logged for

***

## get\_resource\_time

Get items with billable time logged by a user within a date range.

| Property      |     |
| ------------- | --- |
| **Read-only** | Yes |

### Parameters

| Parameter  | Type     | Required | Default    | Description                                                    |
| ---------- | -------- | -------- | ---------- | -------------------------------------------------------------- |
| `userId`   | string   | Yes      | —          | User ID. Use [`get_user_list`](/mcp-tools/user#get_user_list). |
| `fromDate` | DateTime | No       | 7 days ago | Start of date range.                                           |
| `toDate`   | DateTime | No       | Today      | End of date range.                                             |

### Returns

A list of `ResourceTimeDto` objects, each containing:

* `itemId` — the item with time logged
* `containerId` — the item's container
* `sequence` — item sequence number
* `timeEntries` — list of time entries on this item

***

## create\_time\_entry

Create a new non-billable time entry.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter       | Type     | Required | Default | Description                                                                                                            |
| --------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| `userId`        | string   | Yes      | —       | User ID. Use [`get_user_list`](/mcp-tools/user#get_user_list).                                                         |
| `nonBillableId` | string   | Yes      | —       | Non-billable category ID. Use [`get_non_billable_time_code_list`](/mcp-tools/finance#get_non_billable_time_code_list). |
| `timeLogged`    | string   | Yes      | —       | Duration (e.g. `2h 30m`).                                                                                              |
| `dated`         | DateTime | No       | Now     | The date to log time for.                                                                                              |
| `comment`       | string   | No       | —       | Optional comment.                                                                                                      |

### Returns

The created `TimeEntryDto`.

***

## update\_time\_entry

Update a non-billable time entry. Only provided fields are updated.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter     | Type     | Required | Description                                                     |
| ------------- | -------- | -------- | --------------------------------------------------------------- |
| `timeEntryId` | string   | Yes      | The time entry ID. Use [`get_time_entries`](#get_time_entries). |
| `timeLogged`  | string   | No       | New duration.                                                   |
| `comment`     | string   | No       | New comment.                                                    |
| `dated`       | DateTime | No       | New date.                                                       |

### Returns

The updated `TimeEntryDto`.

***

## delete\_time\_entry

Delete a non-billable time entry by its ID.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter     | Type   | Required | Description                                                     |
| ------------- | ------ | -------- | --------------------------------------------------------------- |
| `timeEntryId` | string | Yes      | The time entry ID. Use [`get_time_entries`](#get_time_entries). |

### Returns

A confirmation message.