Use this tool to read the update history of an item or board. For item queries, the response includes each update's text, creator, and timestamps. For board queries, only board-level discussion is returned by default — set includeItemUpdates to true to also include updates posted on individual items within the board.

Date range filtering (fromDate / toDate) is only supported for Board queries and both parameters must be used together. Results are paginated; use page and limit to navigate through large update histories.

Parameters

Parameter	Type	Required	Description
objectId	`string`	Yes	The ID of the item or board to retrieve updates from.
objectType	`string`	Yes	The type of object: `"Item"` or `"Board"`.
limit	`number`	No	Number of updates to return per page. Default: `25`. Maximum: `100`.
page	`number`	No	Page number for pagination. Default: `1`.
includeReplies	`boolean`	No	Set to `true` to include threaded replies on each update. Default: `false`.
includeAssets	`boolean`	No	Set to `true` to include file attachments in the response. Default: `false`.
fromDate	`string`	No	Start of date range filter in ISO 8601 format (e.g. `"2025-01-01"` or `"2025-01-01T00:00:00Z"`). Board queries only. Must be used together with `toDate`.
toDate	`string`	No	End of date range filter in ISO 8601 format. Board queries only. Must be used together with `fromDate`.
includeItemUpdates	`boolean`	No	When `objectType` is `"Board"`, set to `true` to include updates on individual items. Default: `false` (board-level discussion only).

Example

Fetch updates on item 11971936030 including replies:

{
  "objectId": "11971936030",
  "objectType": "Item",
  "includeReplies": true
}

The tool returned 1 update (ID 5179486006) with text "Testing the MCP create_update tool for documentation purposes.", creator Daniel Hai, and an empty replies array. The pagination response showed page: 1, limit: 25, count: 1.

Fetch all updates on a board within a date range:

{
  "objectId": "18412502536",
  "objectType": "Board",
  "fromDate": "2026-01-01",
  "toDate": "2026-05-10",
  "includeItemUpdates": true
}

Programmatic equivalent

Use the GraphQL API to achieve the same result:

query {
  items(ids: [11971936030]) {
    updates(limit: 25, page: 1) {
      id
      body
      text_body
      created_at
      updated_at
      creator {
        id
        name
      }
      replies {
        id
        body
        creator {
          id
          name
        }
      }
    }
  }
}

For full documentation, see Updates.